---
title: "Performs batch phone number verification."
method: POST
path: "/v1/phone-numbers/validate/batch"
tags: ["Phone Verification"]
---

# Performs batch phone number verification.

`POST /v1/phone-numbers/validate/batch`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/phone-numbers/validate/batch`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

This endpoint is for batch phone number verification with a maximum batch size of 10.

## Headers

- `X-Request-Id` string

## Request body

- PhoneValidationBatchRequest: Represents the request for batch phone number verifications.
  - `phoneNumbers` PhoneValidationRequestWithId[], required: A list of phone numbers to be verified, each optionally associated with an ID.
    - `id` string, nullable: Optional identifier for the request.
    - `phoneNumber` string, required: The phone number to be verified.
    - `country` string: Optional input for the country code in ISO2 or ISO3 format.

## Response `200`

Batch phones verified successfully

- PhoneValidationBatchResponse: Represents the response for a batch phone verification request.
  - `responses` PhoneBatchResponse[]: List of responses for the batch phone verification request.
    - `status` 'OK' | 'ZERO_RESULTS': Represents the status of a response
    - `id` string: Alphanumeric ID associated with the phone verification request.
    - `phoneNumber` PhoneValidation: Represents the response for phone verification.
      - `callingCountryCode` string: The country calling code associated with the phone number.
      - `country` string: The country associated with the phone number in ISO2 or ISO3 format.
      - `mobileCountryCode` string: The mobile country code (MCC) of the phone number.
      - `mobileNetworkCode` string: The mobile network code (MNC) of the phone number.
      - `carrierName` string: The name of the carrier associated with the phone number.
      - `phoneType` string: The type of phone number, such as 'mobile' or 'landline'.
      - `nationalNumberFormat` string: The phone number in national format.
      - `formattedPhoneNumber` string: The phone number in international format.
      - `validStatus` boolean: Indicates whether the phone number is valid.
      - `validationDescription` string: A detailed description of the validation result.
      - `qualityScore` string: A quality score for the phone number verification.
    - `code` string: Error code returned by the service, if applicable.
    - `detail` string: Detailed error message provided by the service, if applicable.

## Other responses

- `206`: Batch phones verified Partially
- `400`: Invalid request for batch Phone verification API
- `401`: Unauthorized: Invalid token for batch Phone verification API
- `403`: Forbidden for batch Phone verification API
- `413`: Request entity too large for batch Phone verification API
- `429`: Too many requests for batch Phone verification API
- `500`: Internal server error for batch Phone verification API
- `503`: Batch phones verification service unavailable

---

[API](https://skmtc.dev/precisely/apis/third-party-api-service.md) · [All operations](https://skmtc.dev/precisely/apis/third-party-api-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/third-party-api-service/revisions/cf792ff5cabd?raw)