API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Specification
★  SDKs
Data Tools
Security and Networking

Phone Validate

Parse, validate and get location information about a phone number.

Use this API to validate local and international phone numbers in any country. You can determine what type of number this is (e.g. fixed line or mobile), the location of the number and reformat the number into local and international dialing formats. For numbers within the NANP regions type detection is not always possible for every number, however you can also use HLR Lookup to get full type detection and detailed mobile device information.

End Point

Test API
API Request
numberYesstringA phone number
country-codeNostringISO 2-letter country code, assume numbers are based in this country.
If not set numbers are assumed to be in international format (with or without the leading + sign)
ipNostringPass in a users IP address and we will assume numbers are based in the country of the IP address
API Response
validbooleanIs this a valid phone number
typestringThe number type, possible values are:
  • mobile
  • fixed-line
  • premium-rate
  • toll-free
  • voip
  • unknown
is-mobilebooleanTrue if this a mobile number
locationstringThe phone number location. Could be a city, region or country depending on the type of number
countrystringThe phone number country
country-codestringThe phone number country as an ISO 2-letter country code
international-calling-codeintegerThe international calling code
international-numberstringThe number represented in full international format
local-numberstringThe number represented in local dialing format

Free limit: 25/day