Loading
Loading
Validate up to 100 phone numbers in a single request. Each number is independently checked and returns the same comprehensive data as single validation.
Send an array of phone number objects in the request body. Each object includes the number and optional region fields. Invalid entries do not affect the rest of the batch.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
formatoptionalStringdefault: jsonResponse format: 'json'.
The request body must be in JSON format and include a numbers array of phone number objects:
{
"numbers": [
{
"number": "+14155552671"
},
{
"number": "03301112233",
"region": "PK"
},
{
"number": "0014155552671",
"dialer_region": "AU"
}
]
}numbersrequiredArray<Object>Array of phone number objects to validate. Maximum 100 objects per request.
Each object in the numbers array supports the following fields:
numberrequiredStringThe phone number to validate. Can include international prefix (+), local format, or IDD exit code format.
regionoptionalStringISO-2 country code (e.g., US, GB) for unambiguous parsing.
dialer_regionoptionalStringISO-2 country code of the dialing origin (e.g., AU, US).
A successful request returns a 200 OK response with an array of per-number validation results, one entry for each phone number in the request.
-See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
Please provide data in required format in request body
Maximum allowed limit is 100. The total phone numbers in the request exceeds the limit.
Please provide valid parameters.
The 'number' is required in Post Body and cannot be empty.
Provide the region explicitly (e.g. 'US') or include a '+' with the country code.
The input does not match the expected structure of a phone number.
The number is too short after removing the international dialing prefix.
The national number part is shorter than allowed for valid phone numbers.
The phone number has more digits than any valid phone number can have.
Region code must be a 2-letter ISO country code (e.g., 'US', 'GB').
Only one of 'region' or 'dialer_region' can be provided. Do not use both in the same request.
Wrong HTTP method was used on the endpoint.
Timed out while connecting to the remote URL.