API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Batch Processing
★  Specification
★  SDKs
★  Stats
Data Tools
Telephony
Geolocation
Security and Networking
E-commerce
Imaging

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

https://neutrinoapi.com/phone-validate
Test API
API Request
ParameterRequiredTypeDefaultDescription
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
ParameterTypeDescription
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 instead)
is-mobilebooleanTrue if this is a mobile number (only true with 100% certainty, if the number type is unknown this value will be false)
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
5010,000100,0001,000,000