---
title: "Retrieve validation results"
method: GET
path: "/v1/validation/{request_id}"
tags: ["Number validator"]
---

# Retrieve validation results

`GET /v1/validation/{request_id}`

Returns the results of an asynchronous batch validation identified by `request_id`.

## Path parameters

- `request_id` string, required

## Response `200`

Returns the batch validation results.

- PhoneValidationBatchResultResponse
  - `status` string, required — Request status. Possible values are `success` and `in progress`. - `success`: All numbers were processed. - `in progress`: Several numbers are pending validation.
  - `pending` integer, required — The quantity of phone numbers that are pending to be processed.
  - `count` integer, required — The quantity of phone numbers passed in the request.
  - `items` PhoneValidationResultResponse[], required — Array of objects containing details for each phone number. The returned fields depend on the `type` parameter.
    - `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.

## Other responses

- `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/versions/b22f170488b6/schema)