---
title: "Validate multiple numbers"
method: POST
path: "/v1/validation"
tags: ["Number validator"]
---

# Validate multiple numbers

`POST /v1/validation`

Validates a batch of phone numbers. When `async` is `true`, returns a `request_id` to poll for results instead of the validation details.

## Request body

- PhoneValidationRequest
  - `phone_numbers` string[], required — List of phone numbers to get detailed information about.
  - `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).
  - `async` boolean, required — Indicates whether the request should be executed asynchronously. If `true`, the response will include a `request_uuid` that can be used to poll for results. If `false`, the response will include validation results directly.
  - `force` boolean, required — Indicates whether to force a fresh validation instead of returning a previously cached result.

## Response `200`

Returns the validation results, or a `request_id` when validation is asynchronous.

- union
  - PhoneValidationBatchResponse
    - `status` string, required — Validation request status.
    - `pending` integer, required — Number of validations still in progress.
    - `count` integer, required — Total number of phone numbers in the request.
    - `items` PhoneValidationResultResponse[], required — List of validation results for each phone number.
      - `phone_number` string, required — Phone number.
      - `valid` boolean, required — Indicates whether the phone number is valid.
      - `country_code` string, nullable, required — Phone number country code in ISO 3166-1 alpha-2 format. `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 is ported. `null` if the phone number is invalid.
      - `mcc` string, nullable — Mobile Country Code (MCC). Applies to mobile numbers only. `null` if the phone number is invalid.
      - `mnc` string, nullable — Mobile Network Code (MNC). Applies to mobile numbers only. `null` if the phone number is invalid.
      - `number_type` string, nullable — Phone number type. Allowed values: `mobile`, `landline`, `toll-free`. `null` if the phone number is invalid.
      - `carrier_name` string, nullable — Carrier name. `null` if the phone number is invalid.
      - `risky_destination` boolean, nullable — Indicates whether the phone number belongs to a range associated with traffic pumping. `null` if the phone number is invalid.
      - `unallocated_range` boolean, nullable — Indicates whether the phone number belongs to an unallocated range. `null` if the phone number is invalid.
      - `reachable` boolean, nullable — Indicates whether the number is registered in a mobile network. Applies to mobile numbers only. `null` if the phone number is invalid.
      - `roaming` boolean, nullable — Indicates whether the number is roaming. Applies to mobile numbers only. `null` if the phone number is invalid.
      - `timezone` string, nullable — Time zone identified based on the country and area code. `null` if the phone number is invalid.
      - `charge` string, required — Charge for the validation.
      - `error_code` string, required — Result code for the validation. `000` indicates success. Possible values: - `013` — internal service error, uncategorized. - `021` — invalid phone number length or format. - `041` — remote timeout. - `042` — remote query failed. - `091` — insufficient funds.
  - object — Returned when validation runs asynchronously; poll results using `request_id`.
    - `request_id` string — Request ID. Use to poll validation results when `async` is `true`.

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `403` — Request failed. The feature is disabled for your account.
- `404` — Request failed. An object with the specified ID is not found.

---

[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)