Skip to main content
GET
/
v1
/
validation
Validate a number
curl --request GET \
  --url https://api.wavix.com/v1/validation \
  --header 'Authorization: Bearer <token>'
{
  "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

​
Authorization
string
header
required

Bearer token using appid (Authorization: Bearer )

Query Parameters

​
phone_number
string
required

Phone number in E.164 format or without "+".

Example:

"971569483322"

​
type
enum<string>
required

Validation type.

Available options:
format,
analysis,
validation

Response

Phone number details.

​
phone_number
string
required

Phone number.

Example:

"971569483322"

​
valid
boolean
required

Indicates whether the phone number is valid.

Example:

true

​
country_code
string
required

ISO 3166-1 alpha-2 country code of the phone number. null if the number is invalid.

Example:

"AE"

​
e164_format
string
required

Phone number in international E.164 format.

Example:

"+971569483322"

​
national_format
string
required

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

Number type. Possible values are 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 number is invalid.

Example:

false

​
unallocated_range
boolean
required

Indicates whether the phone number belongs to an unallocated number range. null if the 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 number is invalid

Example:

true

​
roaming
boolean
required

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

Example:

false

​
timezone
string
required

Time zone based on the phone number's country and area code. null if the number is invalid.

Example:

"UTC+04:00"

​
charge
string
required

Charge for the validation.

Example:

"0.015"

​
error_code
string
required

Error code for the request. 000 indicates success. Possible values:

  • 013: — Internal service error
  • 021: — Invalid phone number length or format
  • 041: — Request timeout
  • 042: — Request failed
  • 091: — Insufficient funds
Example:

"000"