Phone Number Validation API

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.

GEThttps://api-bdc.net/data/phone-number-validate

Parameters

ParameterTypeRequiredDescription
numberstringOptionalPhone number to validate
countryCodestringOptionalCountry code, acceptable in ISO 3166-1 Alpha-2, Alpha-3 or Numeric code formats
localityLanguagestringOptionalPreferred 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
keystringOptionalYour API key

Responses

200OK

Sample Request

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

Sample Response

JSON View

Response Schema

isValidbooleanIndicates whether the phone number is valid and dialable in the detected country.
e164FormatstringThe phone number in E.164 international format (e.g. "+61412345678"). This is the canonical format for storage and API calls.
internationalFormatstringThe phone number in international dialling format with spaces (e.g. "+61 412 345 678").
nationalFormatstringThe phone number formatted for local dialling within its country (e.g. "0412 345 678" in Australia).
locationstringEstimated location localised to the language as defined by 'localityLanguage' request parameter
lineTypestringLine 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'
countryobjectcountry object
isoAlpha2stringISO 3166-1 Alpha-2 code
isoAlpha3stringISO 3166-1 Alpha-3 code
m49CodeintegerUnited Nations M.49 code
namestringCountry name localised to the language as defined by 'localityLanguage' request parameter
isoNamestringThe short English country name as defined by ISO 3166-1 (e.g. "Australia").
isoNameFullstringThe full official English country name as defined by ISO 3166-1 (e.g. "Commonwealth of Australia").
isoAdminLanguagesarrayAdministrative languages as defined by ISO 3166-1 standard
isoAlpha3stringISO 3166-1 Alpha-3 code
isoAlpha2stringISO 3166-1 Alpha-2 code
isoNamestringISO 3166-1 Language name
nativeNamestringA native name
unRegionstringRegion name as defined by the United Nations
currencyobjectcurrency object
numericCodeintegerISO 4217 standard numeric code
codestringISO 4217 standard code
namestringISO 4217 English name
minorUnitsintegerISO 4217 minor units as the currency exponent (e.g. 2 = 1/100)
wbRegionobjectwbRegion object
idstringworld bank identification number. the expected values are: 'LCN','NA','SAS','SSF','ECS','MEA','EAS','NAC'
iso2Codestringiso 2 letters code. the expected values are: 'ZJ','NA','8S','ZG','Z7','ZQ','Z4','XU'
valuestringregion 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'
wbIncomeLevelobjectwbIncomeLevel object
idstringworld bank identification number. the expected values are: 'HIC','NA','LIC','LMC','UMC','INX'
iso2Codestringiso 2 letters code. the expected values are: 'XD','NA','XM','XN','XT','XY'
valuestringincome level name. the expected values are: 'High income','Aggregates','Low income','Lower middle income','Upper middle income','Not classified'
callingCodestringThe international dialling (calling) code for the country, without the leading "+" (e.g. "1" for the US, "61" for Australia).
countryFlagEmojistringThe country flag as a Unicode emoji (e.g. "🇦🇺" for Australia), composed from the ISO 3166-1 Alpha-2 regional indicator symbols.
wikidataIdstringWikidata item identifier, if available
geonameIdintegerA unique identifier as is given by GeoNames.org
isIndependentbooleanDetermines if the country/territory is independent according to ISO 3166 records
400Bad request

Sample Response

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

Sample Response

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

Sample Response

JSON View