Phone Number Validation API

Phone numbers are entered in countless formats — local, international, with or without country codes, with spaces, dashes, or brackets. This API normalises and validates them against the E.164 international standard, so you always know what you're working with.

For any phone number and country code, the API returns the normalised E.164 format, international and national display formats, the line type (mobile, fixed-line, VoIP, toll-free, etc.), and country-level context including calling code, currency, and language.

It's useful at the point of data entry — catching invalid numbers before they enter your system — and for cleaning existing customer databases where phone number quality is inconsistent.

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

Parameters

Parameter	Type	Required	Description
`number`	string	Optional	Phone number to validate
`countryCode`	string	Optional	Country code, acceptable in ISO 3166-1 Alpha-2, Alpha-3 or Numeric code formats
`localityLanguage`	string	Optional	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
`key`	string	Optional	Your 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