Phone batch verification API
Verify multiple phone numbers in a single request using real-time validation.
The phone batch verification lets you verify multiple phone numbers in a single request. It is designed for bulk validation tasks, such as verifying customer contact numbers in data cleansing or onboarding flows. Each phone number is processed in real time, and the response includes enriched verification results like network provider, type of number, and geographic country code.
The API supports phone numbers provided in either international format (e.g., "+447528471411") or national format (e.g., "07528471411") when accompanied by a country code. You can use ISO2 (e.g., "GB") or ISO3 (e.g., "GBR") format to specify the country.
Parameters
Use this API to send a JSON array of phone objects to validate. Each object must include a phone field, and optionally a country field.
Operation endpoint:
POST reltio/api/{tenantId}/verification/phone/_batchVerify| Category | Parameter | Required | Description |
|---|---|---|---|
| Headers | Authorization | Yes | Bearer token for authentication. Format: "Bearer accessToken". |
Content-Type | Yes | Must be "application/json". | |
EnvironmentURL | Yes | The Reltio environment URL where the tenant is hosted. | |
| Path | tenantId | Yes | The tenant identifier. The API uses the tenant’s attribute verification configuration to perform validation using Loqate. |
| Body | phone | Yes | The phone number to verify. Can be in international or national format. |
| Body | country | No | Country code in ISO2 or ISO3 format. Required when phone number is not in international format. |
Response structure
- Returns a JSON array where each object corresponds to one phone number submitted in the request.
- Each object contains fields such as
PhoneNumber,CountryPrefix,NationalFormat,NetworkName,NumberType,VerifiedOn,IsValid, andRequestStatus. - If a verification fails, the object includes
RequestStatuswith the error details for that specific record.
Note: The phone batch verification API always performs real-time verification and does not reuse past verification results. The maxVerificationAge parameter is not used for phone verification.
The following fields are included in the phone verification result object:
| Name | Type | Description |
|---|---|---|
| PhoneNumber | String | The normalized international phone number used for verification, including country code. |
| CountryPrefix | Integer | The international dialing prefix of the verified phone number (for example, 1 for US, 91 for India). |
| NationalFormat | String | The phone number displayed in its national format for the detected country. |
| NetworkName | String | The name of the network provider or carrier that owns the phone number block. |
| NumberType | String | The type of phone number detected, such as "Mobile", "Landline", or "VoIP". |
| VerifiedOn | DateTime | Timestamp indicating when the verification was last performed. |
| IsValid | String | Indicates whether the phone number is valid. Possible values are "Yes", "No", or "Unknown". |
| RequestStatus | String | The final result of the verification request. Can include statuses like "Success", "Failure", or error codes. |
Example request
POST reltio/api/{tenantId}/verification/phone/_batchVerify
Authorization: Bearer accessToken
Content-Type: application/json
[
{"phone": "+91 8476547434"},
{"phone": "8674845846", "country": "IN"}
]Example response
[
{
"CountryPrefix": 91,
"RequestProcessed": true,
"NetworkName": "Bharat Sanchar Nigam Ltd (BSNL) (83560049)",
"NumberType": "Landline",
"VerifiedOn": "2025-09-10T09:39:31.566526277Z",
"NationalFormat": "084765 47434",
"PhoneNumber": "+918476547434",
"NetworkCountry": "IN",
"IsValid": "Yes",
"RequestStatus": "Success"
},
{
"CountryPrefix": 91,
"RequestProcessed": true,
"NetworkName": "Airtel India - Bihar Jharkhand (52) (Bharti Airtel)",
"NumberType": "Mobile",
"VerifiedOn": "2025-09-10T09:39:31.117153339Z",
"NationalFormat": "086748 45846",
"PhoneNumber": "+918674845846",
"NetworkCountry": "IN",
"NetworkCode": "52",
"IsValid": "Yes",
"RequestStatus": "Success"
}
]