API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Batch Processing
★  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. 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 number type, possible values are:
  • mobile
  • fixed-line
  • premium-rate
  • toll-free
  • voip
  • unknown (use HLR)
is-mobilebooleanTrue if this is a mobile number (with 100% certainty)
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 (E.164)
local-numberstringThe number represented in local dialing format
Daily Limits
Free TierTier 1Tier 2Tier 3