Phone Number Validation API

Introduction

Similar to an email address, a phone number is an essential customer identifier. It is regularly used by businesses for sending important account updates, announcements, and security codes. Compared to email addresses, phone numbers provide a strong authentication method for account logins and other occasions making it an important data input that needs to be validated during various stages of the customer life-cycle. 

One of the key challenges with phone numbers is getting them properly validated and formatted for storage on a database. People generally tend to format a phone number in a way which is popular within their region. As a result, there are a variety of ways in which businesses build their online form. This has resulted in non-standard practises and confusion between customers and businesses.

The Phone Number Validation API solves these specific problems related to phone number validation and formatting. Using this API, you can validate and convert phone numbers (any format) to the E164 standard format, international format or national format. In addition, the API also identifies the type of phone line, ie fixed-line, mobile, VoIP and so on.  

You can learn more about how to store phone numbers in a database here.

Example Response

The response is only available in JSON format. The below response should be expected for the following request:


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


Awaiting request submission...

API Pricing

  1. Monthly Subscription
    FREE 1,000 queries/month
    Additional 1,000 queries US$1.00/month
  2. Annual Subscription
    FREE 1,000 queries/month
    Additional 1,000 queries US$0.80/month

Request Format

NEW! Payload compression is supported, simply add Accept-Encoding: gzip header.
Use the form below to try out this API.

Parameter Your Input Value Description
number Phone number to validate
countryCode

Default country code, acceptable in:

·       ISO 3166-1 Alpha-2 code

·       ISO 3166-1 Alpha-3 code

·       ISO 3166-1 Numeric code

This will be used to validate phone numbers entered in a national format
localityLanguage

Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 147 common world languages are supported, full list here, 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
key Your API key

Don't have an API Key? Click here to register and get your free API Key

If you already have a BigDataCloud account, to automatically fill this field with your Api Key.

The live query

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


CURL Example

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


Visit our SDK page to access API clients in specific languages like Javascript, Python + PHP.


Response

Awaiting request submission...

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 dialling 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

API Endpoint

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

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 the United Nations

currency

<Currency> object

Currency as defined by ISO 4217 standard

wbRegion

<WbNode> object

Region name as defined by the World Bank

wbIncomeLevel

<WbNode> object

Income level as defined by the World Bank

callingCode

string

Calling code

countryFlagEmoji

string

Country emoji

wikidataId

string

Wikidata item identifier, if available

geonameId

integer

A unique identifier as is given by GeoNames.org

continents

Array of <Continent> object

The list of Continents the Country is located at

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)

WbNode object

Field

Data type

Description

id

string

Identification number

iso2Code

string

ISO 2 letters code

value

string

Value

Related APIs

  1. Phone Number Validation by IP Address API
    FREE 1,000 queries/month
    Additional 1,000 queries
    US$1.00
    /month

    Global Phone Number Formatting and Validation API based on the geolocation of a provided IPv4 address

    • 164 format
    • International dial format
    • Local number format
    • Location Data
    • Line type detection
    Read More

Sidebar