---
title: "Get email validations"
method: GET
path: "/email/2/validations"
tags: ["channels", "email", "email-validation"]
---

# Get email validations

`GET /email/2/validations`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/email/2/validations`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

This method lets you review and analyze the outcomes of your
submitted bulk email validations to gain insights into the quality of your email list.

## Query parameters

- `validationRequestId` string: Unique identifier for the bulk email validation request. Provide your own or leave it blank to have one generated automatically.
- `destination` string[]: The email addresses to search.
- `validMailbox` string: Indicates whether email address is valid.
- `validSyntax` boolean: Indicates whether email address syntax is valid.
- `catchAll` boolean: Indicates catch all status of email address.
- `disposable` boolean: Indicates whether email address is disposable. A disposable email address is a temporary address that is often used for short-term purposes and can be discarded after use.
- `roleBased` boolean: Indicates whether email address is role-based. A role-based email address is one that is associated with a specific function or group within an organization, such as marketing@example.org, rather than an individual person.
- `risk` 'LOW' | 'MEDIUM' | 'HIGH' | 'UNKNOWN': Indicates the risk status of email addresses. High-risk addresses have a very high chance of bouncing and potentially damaging the sender's reputation. Low-risk addresses have a very low chance of bouncing and are less likely to damage the sender's reputation.
- `validatedDateFrom` string, date-time: Start date for searching validations. If not specified, defaults to 7 days before the current date. The date cannot be more than 1 month in the past.
- `validatedDateTo` string, date-time: End date for searching validations.
- `cursor` string: A pagination token for navigating through bulk email validation results. Initially empty, it updates with each API response to fetch the next set of results, ensuring efficient data retrieval.
- `size` integer: Number of records per page.

## Response `200`

Successful response

- 45c843446703ba5f4438a6f721c629420452796de20bd3dd9adfccde3ed2ffffGetValidationPageResponse: Validation get page response.
  - `results` 45c843446703ba5f4438a6f721c629420452796de20bd3dd9adfccde3ed2ffffGetValidation[], required: Validated addresses for requested paging information.
    - `destination` string, required: The validated email address.
    - `validMailbox` string, required: Indicates whether email address is valid.
    - `validSyntax` boolean, required: Indicates whether email address syntax is valid.
    - `catchAll` boolean, required: Indicates catch all status of email address.
    - `didYouMean` string: Suggests similar alternate address that may be valid.
    - `disposable` boolean, required: Indicates whether email address is disposable. A disposable email address is a temporary address that is often used for short-term purposes and can be discarded after use.
    - `roleBased` boolean, required: Indicates whether email address is role-based. A role-based email address is one that is associated with a specific function or group within an organization, such as marketing@example.org, rather than an individual person.
    - `risk` 'LOW' | 'MEDIUM' | 'HIGH' | 'UNKNOWN', required: Indicates the risk status of email addresses. High-risk addresses have a very high chance of bouncing and potentially damaging the sender's reputation. Low-risk addresses have a very low chance of bouncing and are less likely to damage the sender's reputation.
    - `reason` 'TIMED_OUT' | 'TEMP_REJECTION' | 'THROTTLED' | 'INBOX_FULL' | 'UNABLE_TO_CONNECT' | 'UNEXPECTED_FAILURE': Reason is provided when validMailbox status is unknown. 1. INBOX_FULL - The user quota exceeded / The user inbox is full / The user doesn't accept any more requests. 2. UNEXPECTED_FAILURE - The mail Server returned a temporary error. 3. THROTTLED - The mail server is not allowing us momentarily because of too many requests. 4. TIMED_OUT - The mail Server took a longer time to respond / there was a delay in the network. 5. TEMP_REJECTION - Mail server temporarily rejected. 6. UNABLE_TO_CONNECT - Unable to connect to the Mail Server.
    - `detailedReasons` string: This field is provided when the validMailbox status is 'unknown' or 'false', offering specific explanations for why the email address has been assigned that status.
    - `bulkValidationDate` string, date-time, required: Date and time when email address was validated.
    - `validationRequestId` string: Unique identifier for the bulk email validation request. Provide your own or leave it blank to have one generated automatically.
  - `paging` 45c843446703ba5f4438a6f721c629420452796de20bd3dd9adfccde3ed2ffffCursorPageInfo, required: Paging response.
    - `size` integer, required: Requested page size.
    - `previousCursor` string, required: The previous cursor, empty if there are no previous results.
    - `nextCursor` string, required: The next cursor, empty if there are no subsequent results.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)