Phone Number Validation API

Introduction

BigDataCloud's Phone Number Validation API is a simple yet powerful tool that offers worldwide international and national phone number validation based on the E.164, international telephone numbering plan. This API helps businesses maintain an accurate and clean customer database by identifying and validating phone numbers.

Phone numbers serve as vital customer identifiers for businesses for sending crucial updates, security OTP codes, and other important information. However, phone numbers are often inputted in various formats, causing inconsistencies and confusion for users when filling out contact information on forms, e-commerce/financial sites, and other platforms.

The Phone Number Validator API effectively addresses these concerns by validating and converting phone numbers to conform to the E.164 standard, international format, or national format, and determining the type of phone line (fixed-line, mobile, VoIP, etc.). Additionally, BigDataCloud’s phone number verification API offers country-level data, such as language, currency, income level, calling code, and flags, which enriches your customer data.

The advantages of utilising this API include minimising the risk of losing potential customers due to invalid contact information, streamlining the customer data cleaning and formatting process, reducing costs by detecting invalid phone numbers in SMS and voice call marketing campaigns, and mitigating the likelihood of spammers and malicious actors entering invalid phone numbers.

For more information, check out BigDataCloud's blog posts related to phone number verification.

Get Started

This API is part of the Phone number and Email verification and is available in free and paid plans. Please visit the Phone number and Email verification package page for limits and pricing information.

Endpoints

IPv4 only API Endpoint

Use this endpoint to force API calls routed over the IPv4 network only

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

Dual-Stack API Endpoint

This endpoint has native IPv6 support and backs the API calls routed over both IPv4 and IPv6 networks

GET
https://api-bdc.net/data/phone-number-validate

Request

Parameter
number
Type
string
Required
Yes
Description
Phone number to validate
Parameter
countryCode
Type
string
Required
Yes
Description
Country code, acceptable in ISO 3166-1 Alpha-2, Alpha-3 or Numeric code formats
Parameter
localityLanguage
Type
string
Required
Optional, default value: en
Description
Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. If the requested language is not available for a requested location, it will default to English. If no English variant is known, will provide the native, local names
Parameter
key
Type
string
Required
Yes
Description
Your API key

Responses

200
Success

Sample Query

GET
https://api-bdc.net/data/phone-number-validate?number=201+867-5309&countryCode=us&localityLanguage=en&key=[YOUR API KEY]

Schema

application/json
isValidboolean
Indicates whether the number is valid
e164Formatstring
The number formatted in E164 standard format
internationalFormatstring
The number formatted in International dial format
nationalFormatstring
The number formatted in local dial format
locationstring
Estimated location localised to the language as defined by 'localityLanguage' request parameter
lineTypestring
Line type detected. Possible values are: 'FIXED_LINE', 'MOBILE', 'FIXED_LINE_OR_MOBILE', 'TOLL_FREE', 'PREMIUM_RATE', 'SHARED_COST', 'VOIP', 'PERSONAL_NUMBER', 'PAGER', 'UAN', 'VOICEMAIL', 'UNKNOWN'
country
country object
isoAlpha2string
ISO 3166-1 Alpha-2 code
isoAlpha3string
ISO 3166-1 Alpha-3 code
m49Codeinteger
United Nations M.49 code
namestring
Country name localised to the language as defined by 'localityLanguage' request parameter
isoNamestring
ISO 3166-1 Country name short
isoNameFullstring
ISO 3166-1 Country name full
isoAdminLanguagesarray
Administrative languages as defined by ISO 3166-1 standard
isoAlpha3string
ISO 3166-1 Alpha-3 code
isoAlpha2string
ISO 3166-1 Alpha-2 code
isoNamestring
ISO 3166-1 Language name
nativeNamestring
A native name
unRegionstring
Region name as defined by the United Nations
currency
currency object
numericCodeinteger
ISO 4217 standard numeric code
codestring
ISO 4217 standard code
namestring
ISO 4217 English name
minorUnitsinteger
ISO 4217 minor units as the currency exponent (e.g. 2 = 1/100)
wbRegion
wbRegion object
idstring
world bank identification number. the expected values are: 'LCN','NA','SAS','SSF','ECS','MEA','EAS','NAC'
iso2Codestring
iso 2 letters code. the expected values are: 'ZJ','NA','8S','ZG','Z7','ZQ','Z4','XU'
valuestring
region name. the expected values are: 'Latin America & Caribbean','Aggregates','South Asia', 'Sub-Saharan Africa','Europe & Central Asia','Middle East & North Africa','East Asia & Pacific','North America'
wbIncomeLevel
wbIncomeLevel object
idstring
world bank identification number. the expected values are: 'HIC','NA','LIC','LMC','UMC','INX'
iso2Codestring
iso 2 letters code. the expected values are: 'XD','NA','XM','XN','XT','XY'
valuestring
income level name. the expected values are: 'High income','Aggregates','Low income','Lower middle income','Upper middle income','Not classified'
callingCodestring
Calling code
countryFlagEmojistring
Country emoji
wikidataIdstring
Wikidata item identifier, if available
geonameIdinteger
A unique identifier as is given by GeoNames.org
isIndependentboolean
Determines if the country/territory is independent according to ISO 3166 records

Sample Response

JSON View
400
Bad request

Sample Response

JSON View
403
Access denied, or your quota limit has exceeded

Sample Response

JSON View
500
An error has occurred and did not complete your request. Please try again

Sample Response

JSON View
Was this page helpful?