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.
Endpoint
Request
Responses
200OK
Sample Query
Schema
isValidbooleanIndicates whether the number is valid
e164FormatstringThe number formatted in E164 standard format
internationalFormatstringThe number formatted in International dial format
nationalFormatstringThe number formatted in local dial format
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'
countrycountry 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
isoNamestringISO 3166-1 Country name short
isoNameFullstringISO 3166-1 Country name full
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
currencycurrency 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)
wbRegionwbRegion 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'
wbIncomeLevelwbIncomeLevel 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'
callingCodestringCalling code
countryFlagEmojistringCountry emoji
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
Sample Response
400Bad request
Sample Response
403Access denied, or your quota limit has exceeded
Sample Response
500An error has occurred and did not complete your request. Please try again
Sample Response