📞
Phone Validator API
Make sure your contact lists are accurate and up-to-date with our Phone Validator API. Improve your contact rate and extract information from global phone numbers.
You need to provide your API key for every API request you make. Please refer to the Getting Started section for more details.
You can check our Errors section to understand how we handle errors and the responses you will receive in cases when errors occur.

Validate phone number (/validate)

Effortlessly integrated API endpoint for validating the desired phone number.

Request parameters

Key
Explanation
Required
phone
The phone number you want to validate and obtain details for.
true
You can provide phone parameter values with or without the "+" prefix.

Example

GET /validate?phone=+4915903921132
RESPONSE:
{
"phone": "+4915903921132",
"valid": true,
"type": "mobile",
"format": {
"local": "01590 3921132",
"international": "+4915903921132"
},
"country": {
"code": "DE",
"name": "Germany",
"prefix": "+49",
"timezone": "Europe/Berlin"
}
}

Response structure

Every successful response will have the structure explained in the table below:
Key
Explanation
Type
phone
The phone number value provided in the request
string
valid
Indicates whether a provided phone number is valid.
boolean
type
Type of the phone number provided. The possible values are: mobile, fixed_line, fixed_line_or_mobile, premium_rate, toll_free, shared_cost, voip, personal_number, pager, uan, voicemail.
string
format.local
Local format of the phone number provided in the request.
string
format.international
International format of the phone number provided in the request.
string
country.code
Country’s two-letter code provided in ISO 3166-1 alpha-2 format extracted from phone number.
string
country.name
Country’s full name extracted from phone number.
string
country.prefix
Country’s calling code prefix extracted from phone number.
string
country.timezone
Country’s timezone extracted from phone number.
string
Copy link
On this page
Validate phone number (/validate)
Request parameters
Example
Response structure