Validate multiple phone numbers

curl --request POST \
  --url 'https://api.wavix.com/v1/validation?appid=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_numbers": [
    "971501390098",
    "971504359195"
  ],
  "type": "format",
  "async": true,
  "force": true
}
'

{
  "status": "success",
  "pending": 0,
  "count": 1000,
  "items": [
    {
      "phone_number": "971569483322",
      "valid": true,
      "country_code": "AE",
      "e164_format": "+971569483322",
      "national_format": "056 948 3322",
      "ported": false,
      "mcc": "424",
      "mnc": "004",
      "number_type": "mobile",
      "carrier_name": "Etisalat",
      "risky_destination": false,
      "unallocated_range": false,
      "reachable": true,
      "roaming": false,
      "timezone": "UTC+04:00",
      "charge": "0.015",
      "error_code": "000"
    }
  ]
}

Number Validator

Validate multiple phone numbers

Use this method to get detailed information about several phone numbers with a single request. Under most circumstances, it takes about 30 seconds to validate a batch of 1,000 phone numbers. We recommend using async:true if you plan to validate more than 1,000 numbers.

A maximum of 100,000 phone numbers per request is allowed.

When you execute the request asynchronously, Wavix immediately starts to validate the phone numbers and returns a token that needs to be used to poll the results.

{
  "request_uuid": "12542c5c-1a17-4d12-a163-5b68543e75f6"
}

POST

validation

Validate multiple phone numbers

curl --request POST \
  --url 'https://api.wavix.com/v1/validation?appid=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_numbers": [
    "971501390098",
    "971504359195"
  ],
  "type": "format",
  "async": true,
  "force": true
}
'

{
  "status": "success",
  "pending": 0,
  "count": 1000,
  "items": [
    {
      "phone_number": "971569483322",
      "valid": true,
      "country_code": "AE",
      "e164_format": "+971569483322",
      "national_format": "056 948 3322",
      "ported": false,
      "mcc": "424",
      "mnc": "004",
      "number_type": "mobile",
      "carrier_name": "Etisalat",
      "risky_destination": false,
      "unallocated_range": false,
      "reachable": true,
      "roaming": false,
      "timezone": "UTC+04:00",
      "charge": "0.015",
      "error_code": "000"
    }
  ]
}

Authorizations

appid

string

query

required

An API key to authorize your request

Body

application/json

Async validation request

phone_numbers

string[]

required

An array of phone numbers to get detailed information about

Example:

["971501390098", "971504359195"]

type

enum<string>

required

Phone number validation type

Available options:

format,

analysis,

validation

async

boolean

required

Indicates whether the request should be executed asynchronously. The default value is false.

Example:

true

force

boolean

required

Force

Example:

true

Response

Validatemultiplenumbersresponse
Option 2

status

string

required

status

Example:

"success"

pending

integer

required

Example:

0

count

integer<int32>

required

The quantity of phone numbers passed in the request.

Example:

1000

items

NumberValidatorResponse · object[]

required

An array of JSON objects containing detailed information about each phone number. The list of parameters returned is determined by the type parameter passed in the request.

Show child attributes

items.phone_number

string

required

The phone number sent in the request

Example:

"971569483322"

items.valid

boolean

required

Indicates if the phone number is valid or not

Example:

true

items.country_code

string

required

2-letter ISO code of the country of the phone number. null if the phone number is invalid.

Example:

"AE"

items.e164_format

string

required

The phone number in the international E.164 format.

Example:

"+971569483322"

items.national_format

string

required

The phone number in the national format of the identified country.

Example:

"056 948 3322"

items.ported

boolean

required

Indicates whether the phone number was ported or not. null if the phone number is invalid.

Example:

false

items.mcc

string

required

Mobile Country Code of the phone number carrier. For mobile phone numbers only. null if the phone number is invalid.

Example:

"424"

items.mnc

string

required

Mobile Network Code of the phone number carrier. For mobile phone numbers only. null if the phone number is invalid

Example:

"004"

items.number_type

string

required

Phone number type. Can be one of mobile, landline, or toll-free. null if the phone number is invalid.

Example:

"mobile"

items.carrier_name

string

required

Name of the phone number carrier. null if the phone number is invalid.

Example:

"Etisalat"

items.risky_destination

boolean

required

Indicates whether the phone number belongs to a number range associated with traffic pumping. null if the phone number is invalid

Example:

false

items.unallocated_range

boolean

required

Indicates whether the phone number belongs to an unallocated number range. null if the phone number is invalid

Example:

false

items.reachable

boolean | null

required

Indicates whether the number is registered in a mobile network. For mobile phone numbers only. null if the phone number is invalid

Example:

true

items.roaming

boolean | null

required

Indicates whether the number is roaming. For mobile phone numbers only. null if the phone number is invalid

Example:

false

items.timezone

string

required

The time zone identified based on the phone number country and area code. null if the phone number is invalid

Example:

"UTC+04:00"

items.charge

string

required

Price of the validation.

Example:

"0.015"

items.error_code

string

required

Contains an error code if any. “000” indicates success. Other possible error_code values: 013 - Internal service error 021 - Invalid phone number length or format 041 - Request timeout 042 - Request failed 091 - Insufficient funds

Example:

"000"

Validate a single phone number

Get asynchronous validation results

Using the APIs

API reference

Validate multiple phone numbers

Authorizations

Body

Response