Mobile Number Validation API - Onboarding Buddy

The Onboarding Buddy Mobile Number Validation API enables developers to validate mobile numbers, checking format, carrier, and line type for user verification in onboarding, authentication, or compliance processes. Ideal for registration systems, SMS campaigns, or KYC workflows, this API offers single and batch validation endpoints to enhance data accuracy and security.

Sign Up for Mobile Number Validation API

Why Use the Onboarding Buddy Mobile Number Validation API?

Validate mobile numbers to ensure reliable user data, reduce fraud, and comply with regulatory requirements. The Onboarding Buddy API verifies mobile number formats, identifies carriers, and determines line types (e.g., mobile, landline), making it a powerful tool for developers and businesses. Use it to streamline onboarding, enhance SMS marketing, or strengthen authentication flows.

Key Features

• Single Mobile Validation: Instantly verify one mobile number for format, carrier, and line type.
• Batch Validation: Process multiple mobile numbers in a single request for efficiency.
• Carrier Identification: Retrieve carrier details to support targeted communications.
• Line Type Detection: Identify whether a number is mobile, landline, or VoIP to prevent invalid registrations.
• Secure API Access: Use App Key, API Key, and API Secret for authenticated requests.

Relevant Endpoints

Endpoint	Method	Purpose
POST /validation-service/validation/mobile	POST	Validates a single mobile number and returns the validation response.
POST /validation-service/batch/mobile	POST	Validates a batch of mobile numbers and returns a batch validation response.
GET /validation-service/batch/poll/{batchId}	GET	Polls the status of a submitted batch validation request using the batch ID.
GET /validation-service/batch/mobile/{batchId}	GET	Retrieves the validation results for a batch of mobile numbers using the batch ID.

Code Samples

Validate a Single Mobile Number

Use the POST /validation-service/validation/mobile endpoint to validate a single mobile number. Include your API credentials in the headers for secure access.

curl -X POST https://api.onboardingbuddy.co/validation-service/validation/mobile \
-H "ob-app-key: your-app-key" \
-H "ob-api-key: your-api-key" \
-H "ob-api-secret: your-api-secret" \
-H "Content-Type: application/json" \
-d '{"mobile": "+12025550123"}'
    

Example Response:

{
  "isValid": true,
  "details": {
    "format": "valid",
    "country": "US",
    "carrier": "Verizon",
    "lineType": "mobile"
  }
}
    

Validate a Batch of Mobile Numbers

Use the POST /validation-service/batch/mobile endpoint to validate multiple mobile numbers efficiently.

curl -X POST https://api.onboardingbuddy.co/validation-service/batch/mobile \
-H "ob-app-key: your-app-key" \
-H "ob-api-key: your-api-key" \
-H "ob-api-secret: your-api-secret" \
-H "Content-Type: application/json" \
-d '{"mobiles": ["+12025550123", "+447700900123", "+invalid"]}'
    

Example Response:

{
  "batchId": "batch-67890",
  "status": "processing"
}
    

Poll Batch Validation Status

Check the status of a batch validation request using the GET /validation-service/batch/poll/{batchId} endpoint.

curl -X GET https://api.onboardingbuddy.co/validation-service/batch/poll/batch-67890 \
-H "ob-app-key: your-app-key" \
-H "ob-api-key: your-api-key" \
-H "ob-api-secret: your-api-secret"
    

Example Response:

{
  "batchId": "batch-67890",
  "status": "completed"
}
    

Retrieve Batch Validation Results

Retrieve the results of a completed batch validation using the GET /validation-service/batch/mobile/{batchId} endpoint.

curl -X GET https://api.onboardingbuddy.co/validation-service/batch/mobile/batch-67890 \
-H "ob-app-key: your-app-key" \
-H "ob-api-key: your-api-key" \
-H "ob-api-secret: your-api-secret"
    

Example Response:

{
  "batchId": "batch-67890",
  "results": [
    {
      "mobile": "+12025550123",
      "isValid": true,
      "details": {
        "format": "valid",
        "country": "US",
        "carrier": "Verizon",
        "lineType": "mobile"
      }
    },
    {
      "mobile": "+447700900123",
      "isValid": true,
      "details": {
        "format": "valid",
        "country": "UK",
        "carrier": "EE",
        "lineType": "mobile"
      }
    },
    {
      "mobile": "+invalid",
      "isValid": false,
      "details": {
        "format": "invalid"
      }
    }
  ]
}
    

Applications of Mobile Number Validation

The Onboarding Buddy Mobile Number Validation API is ideal for:

• User Onboarding: Verify mobile numbers during registration to ensure accurate user data.
• Two-Factor Authentication: Confirm valid mobile numbers for secure SMS-based authentication.
• SMS Marketing: Validate mobile numbers to reduce failed deliveries and optimize campaign performance.
• KYC Compliance: Include mobile validation in identity verification processes for regulatory compliance.

Next Steps

Get started with the Onboarding Buddy Mobile Number Validation API today. Sign up to obtain your API credentials, explore the full API documentation, or discover other use cases like email validation or sanctions checks. For technical details, view all API endpoints.

Start Validating Mobile Numbers Now