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

# Performs single phone number verification.

`POST /v1/phone-numbers/validate`

## Request

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

This endpoint is for single phone number verification.

## Headers

- `X-Request-Id` string

## Request body

- PhoneValidationSingleRequest: Request for single phone verification, including optional country code for verification assistance.
  - `phoneNumber` string, required: Phone number to be verified. Include the country code if applicable.
  - `country` string: Optional country code in ISO2 or ISO3 format to assist in phone number verification.

## Response `200`

Phone verified successfully

- PhoneValidationSingleResponse: Represents the response for a single phone verification request.
  - `response` PhoneSingleResponse: Represents the response for a single phone verification request, including the status and verification details of the phone number.
    - `status` 'OK' | 'ZERO_RESULTS', required: Represents the status of a response
    - `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.

## Other responses

- `400`: Invalid request for phone verification API
- `401`: Unauthorized: Invalid token for phone verification API
- `403`: Forbidden for phone verification API
- `429`: Too many requests for phone verification API
- `500`: Internal server error for phone verification API
- `503`: Phone 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)