---
title: "Validate a number"
method: GET
path: "/v1/validation"
tags: ["Number validator"]
---

# Validate a number

`GET /v1/validation`

Validates a single phone number and returns line type, carrier, portability, and reachability details.

## Query parameters

- `phone_number` string, required
- `type` 'format' | 'analysis' | 'validation', required — Depth of validation to perform on the phone number. One of `format` (checks number syntax only), `analysis` (returns number metadata such as type and country), or `validation` (performs a live network lookup of the number's current status).

## Response `200`

Returns the phone number validation details.

- object
  - `phone_number` string, required — Phone number.
  - `valid` boolean, required — Indicates whether the phone number is valid.
  - `country_code` string, nullable, required — ISO 3166-1 alpha-2 country code of the phone number. `null` if the number is invalid.
  - `e164_format` string, required — Phone number in international E.164 format.
  - `national_format` string, required — Phone number in the national format of the identified country.
  - `ported` boolean, nullable — Indicates whether the phone number was ported or not. `null` if the phone number is invalid.
  - `mcc` string, nullable — Mobile Country Code of the phone number carrier. For mobile phone numbers only. `null` if the phone number is invalid.
  - `mnc` string, nullable — Mobile Network Code of the phone number carrier. For mobile phone numbers only. `null` if the phone number is invalid
  - `number_type` string, nullable — Number type. Possible values are `mobile`, `landline`, or `toll-free`. `null` if the phone number is invalid.
  - `carrier_name` string, nullable — Name of the phone number carrier. `null` if the phone number is invalid.
  - `risky_destination` boolean, nullable — Indicates whether the phone number belongs to a number range associated with traffic pumping. `null` if the number is invalid.
  - `unallocated_range` boolean, nullable — Indicates whether the phone number belongs to an unallocated number range. `null` if the number is invalid
  - `reachable` boolean, nullable — Indicates whether the number is registered in a mobile network. For mobile phone numbers only. `null` if the number is invalid
  - `roaming` boolean, nullable — Indicates whether the number is roaming. For mobile phone numbers only. `null` if the number is invalid
  - `timezone` string, nullable — Time zone based on the phone number's country and area code. `null` if the number is invalid.
  - `charge` string, required — Charge for the validation.
  - `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

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `403` — Request failed. The feature is disabled for your account.

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/revisions/b22f170488b6/schema)