Skip to main content
GET
/
validation
Validate a single phone number
curl --request GET \
  --url https://api.wavix.com/v1/validation
{
  "phone_number": "971569483322",
  "valid": true,
  "country_code": "AE",
  "e164_format": "+971569483322",
  "national_format": "056 948 3322",
  "ported": false,
  "mcc": "424",
  "mnc": "02",
  "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

Query Parameters

​
phone_number
string
required

Phone number to validate. May be formatted with or without the “+” leading sign.

Example:

"971569483322"

​
type
enum<string>
required

Validation type Phone number validation type

Available options:
format,
analysis,
validation

Response

​
phone_number
string
required

The phone number sent in the request

Example:

"971569483322"

​
valid
boolean
required

Indicates if the phone number is valid or not

Example:

true

​
country_code
string
required

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

Example:

"AE"

​
e164_format
string
required

The phone number in the international E.164 format.

Example:

"+971569483322"

​
national_format
string
required

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

Example:

"056 948 3322"

​
ported
boolean
required

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

Example:

false

​
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"

​
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"

​
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"

​
carrier_name
string
required

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

Example:

"Etisalat"

​
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

​
unallocated_range
boolean
required

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

Example:

false

​
reachable
boolean
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

​
roaming
boolean
required

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

Example:

false

​
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"

​
charge
string
required

Price of the validation.

Example:

"0.015"

​
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"

⌘I