Email batch verification API
Verify multiple email addresses in a single request.
The email batch verification lets you verify multiple email addresses in one request. It is designed for large-scale verification or scheduled cleanup jobs, where you need to validate multiple emails at once without triggering individual API calls for each address. Each email is verified in real time, and the response includes enriched verification results such as status, deliverability, and domain information.
Parameters
Use this API to send a batch of up to 100 email addresses for verification. Each address is processed individually, and the results are returned in a single response payload. The verification is performed in real time.
Operation Endpoint:
POST reltio/api/{tenantId}/verification/email/_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 | email | Yes | A JSON array of objects containing the email addresses to verify. Each object must include an email field. The request can include up to 100 records per call. |
Response structure
- Returns a JSON array where each object corresponds to one email address submitted in the request.
- Each object contains fields such as
Status,Account,Domain,IsDisposable,IsSystemMailbox,VerifiedOn, andRequestStatus. - If a verification fails, the object includes
RequestStatuswith the error details for that specific record.
| Name | Type | Description |
|---|---|---|
| Status | String | The verification result status. This attribute can be:
|
| Account | String | The email account name, extracted from the address if available. |
| Domain | String | The domain part of the email address, such as "example.com". |
| IsDisposable | Boolean | Indicates whether the email address is from a disposable provider. |
| IsSystemMailbox | Boolean | Indicates whether the email is a system-generated or non-user mailbox (e.g., "noreply@example.com"). |
| VerifiedOn | DateTime | Timestamp indicating when the verification was last performed. |
| 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/email/_batchVerify
Authorization: Bearer <accessToken>
Content-Type: application/json
[
{"email": "jacob.evans27@gmail.com"},
{"email": "jane.smith2@gmail.com"}
]Example response
[
{
"Status": "Valid",
"Account": "jacob.evans27",
"Domain": "gmail.com",
"IsDisposable": false,
"IsSystemMailbox": false,
"EmailAddress": "jacob.evans27@gmail.com",
"VerifiedOn": "2025-09-10T09:35:03.807Z",
"RequestStatus": "Success"
},
{
"Status": "Valid",
"Account": "jane.smith2",
"Domain": "gmail.com",
"IsDisposable": false,
"IsSystemMailbox": false,
"EmailAddress": "jane.smith2@gmail.com",
"VerifiedOn": "2025-09-10T09:35:03.807Z",
"RequestStatus": "Success"
}
]