API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Batch Processing
★  Specifications
★  Best Practice
★  SDKs
★  Stats
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. Determine the location of the number and reformat the number into local and international dialing formats. We can also determine the line type (e.g. fixed or mobile) without the need to talk to the carrier network. Please note however that type detection is not possible for all countries, notably most of the NANP region. In cases where the number type returns "unknown" you can utilize an HLR Lookup to get carrier level type detection as well as more detailed mobile device information.

End Point

Test API
API Request
numberyesstringA phone number. This can be in international format (E.164) or local format. If passing local format you should use the 'country-code' or 'ip' options as well
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 predicted number type.
Note: type detection is not possible in some countries which have no predictable prefix pattern (you can use the HLR Lookup API in these cases)
Possible values are:
  • mobile
  • fixed-line
  • premium-rate
  • toll-free
  • voip
  • unknown (use HLR lookup)
is-mobilebooleanTrue if this is a mobile number. If the number type is unknown this value will be false, use HLR lookup instead
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
country-code3stringThe phone number country as an ISO 3-letter country code
currency-codestringISO 4217 currency code associated with the country
international-calling-codeintegerThe international calling code
international-numberstringThe number represented in full international format (E.164)
local-numberstringThe number represented in local dialing format
Daily Limits
Free TierTier 1Tier 2Tier 3