Phone Number Validation by IP Address API

JavaScript seems to be disabled in your browser. For the best experience on our site, be sure to turn on Javascript in your browser.

Introduction

Global Phone Number Formatting and Validation API including localised formatting and validation based on IP Geolocation results.

Try It Now

Use the form below to try out this API.

Parameters

Parameter	Type	Your Input Value
number	string
ip	string
localityLanguage	string
key	string	Don't have an API Key? Click here to register and get your free API Key If you already have a BigDataCloud account, you can log in to automatically fill this field with your Api Key.

Curl

curl -X GET --header 'Accept: application/json' 'https://api.bigdatacloud.net/data/phone-number-validate-by-ip'

Request URL

https://api.bigdatacloud.net/data/phone-number-validate-by-ip

Response

Awaiting request submission...

API Pricing

Monthly Subscription

FREE 1,000 queries/month

Additional 1,000 queries US$1.00/month

Add To My Subscription
Annual Subscription

FREE 1,000 queries/month

Additional 1,000 queries US$0.80/month

Add To My Subscription

API Endpoint

Endpoint:	/data/phone-number-validate-by-ip
Full URL:	https://api.bigdatacloud.net/data/phone-number-validate-by-ip

Request Format

Order	Parameter	Required	Data type	Description
1	number	Yes	string	Phone number to validate
2	ip	Yes	string	IPv4 IP address in a string or numeric format. If omitted, the caller’s IP address is assumed. The default country of the phone number formatting will be determined by the IP address geolocation
3	localityLanguage	No	string	Preferred language for locality names in ISO 639-1 format. Please note: all languages are supported, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided
4	key	Yes	string	Your API key

Response Format

Field	Data type	Description
isValid	boolean	Indicates if the number is valid
e164Format	string	The number formatted in E164 standard format
internationalFormat	string	The number formatted in International dialing format
nationalFormat	string	The number formatted in local dial format
location	string	Estimated location localised to the language as defined by ‘localityLanguage’ request parameter
lineType	string	Line type detected. Possible values: FIXED_LINE MOBILE FIXED_LINE_OR_MOBILE TOLL_FREE PREMIUM_RATE SHARED_COST VOIP PERSONAL_NUMBER PAGER UAN VOICEMAIL UNKNOWN
country	<Country> object	Detected Country info

Data Objects

Country object

Field	Data type	Description
isoAlpha2	string	ISO 3166-1 Alpha-2 code
isoAlpha3	string	ISO 3166-1 Alpha-3 code
m49Code	16 bit integer	United Nations M.49 code
name	string	Country name localised to the language as defined by ‘localityLanguage’ request parameter
isoName	string	ISO 3166-1 Country name
isoAdminLanguages	Array of <Language> objects	Administrative languages as defined by ISO 3166-1 standard
unRegion	string	Region name as defined by United Nations
currency	<Currency> object	Currency as defined by ISO 4217 standard
wbRegion	<WbNode> object	Region name as defined by World Bank
wbIncomeLevel	<WbNode> object	Income level as defined by World Bank
callingCode	string	Calling code
countryFlagEmoji	string	Country emoji

Language object

Field	Data type	Description
isoAlpha2	string	ISO 3166-1 Alpha-2 code
isoAlpha3	string	ISO 3166-1 Alpha-3 code
isoName	string	ISO 3166-1 Language name
nativeName	string	Language native name

Currency object

Field	Data type	Description
numericCode	string	ISO 4217 standard numeric code
code	string	ISO 4217 standard code
Name	string	ISO 4217 English name
minorUnits	byte	ISO 4217 minor units as the currency exponent (e.g. 2 = 1/100)

Related APIs