📞

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

Key	Explanation	Required
`phone`	The phone number you want to validate and obtain details for.	`true`

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`

Email Validator API

Banking Details API

Last modified 1yr ago