Phone batch verification

Learn more about how to verify multiple phone numbers in a single request using real-time validation.

Use the Phone batch verification to verify multiple phone numbers in a single request. It is designed for bulk validation scenarios, such as checking contact numbers during onboarding or data cleansing. Each phone number is verified in real time, and the response returns verification results for each submitted value.

Note: This API does not update data in Reltio, so you can use it in external applications or validate phone numbers before loading data into Reltio.

The API accepts phone numbers in international format, such as +447528471411, or in national format, such as 07528471411, when you also provide a country code. The country field supports ISO2 codes, such as GB, and ISO3 codes, such as GBR.

The Phone batch verification always performs real-time verification and does not reuse previous verification results. You can send up to 100 email addresses in a single request.

HTTP method and endpoint

Use the following HTTP method and endpoint path to submit the request:

POST {EnvironmentURL}/reltio/api/{tenantId}/verification/phone/_batchVerify

Replace {EnvironmentURL} with your Reltio environment URL.

The following table describes the endpoint path parameters.


Parameter	Type	Required	Description
`tenantId`	String	Yes	The unique identifier of the tenant. Specifies the tenant context for the request.

Request headers

The following request headers must be included.


Header	Value	Required
`Authorization`	Bearer `<access_token>`	Yes
`Content-Type`	application/json	Yes

Request body

The following table describes the request body parameters, including accepted values and defaults.


Parameter	Type	Required	Description	Accepted values / Default
`phone`	String	Yes	The phone number to verify. The value can be in international or national format.	No default
`country`	String	No	The country code used when the phone number is not in international format.	ISO2 or ISO3 country code

Example request

Use the following example to see how a complete request is structured with headers and a JSON body.

POST {EnvironmentURL}/reltio/api/{tenantId}/verification/phone/_batchVerify
Authorization: Bearer <accessToken>
Content-Type: application/json

[
  {"phone": "+91 8476547434"},
  {"phone": "8674845846", "country": "IN"}
]

Response body

The following table describes the fields returned in the response body.


Field	Type	Description
`PhoneNumber`	String	Normalized international phone number used for verification, including the country code.
`CountryPrefix`	Integer	International dialing prefix of the verified phone number.
`NationalFormat`	String	Phone number formatted for the detected country.
`NetworkName`	String	Name of the network provider or carrier associated with the number.
`NumberType`	String	Type of phone number detected, such as `Mobile`, `Landline`, or `VoIP`.
`VerifiedOn`	DateTime	Timestamp that shows when the verification was performed.
`IsValid`	String	Indicates whether the phone number is valid. Possible values include `Yes`, `No`, or `Unknown`.
`RequestStatus`	String	Result of the verification request for that phone number. If verification fails, this field contains the status or error details for that record.

Example response

The following example shows a response with one result object for each submitted phone number.

[
  {
    "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"
  }
]

Unify and manage your data