channels
email
email-validation

Get email validations

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.

get/email/2/validations

Request

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

Query parameters

validationRequestIdstring

Unique identifier for the bulk email validation request. Provide your own or leave it blank to have one generated automatically.

Example:2034072219640523072
destinationstring[]

The email addresses to search.

[
  "[\"john.smith@example.org\",\"jane.doe@example.org\"]"
]
validMailboxstring

Indicates whether email address is valid.

Example:true
validSyntaxboolean

Indicates whether email address syntax is valid.

Example:true
catchAllboolean

Indicates catch all status of email address.

disposableboolean

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.

roleBasedboolean

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.

validatedDateFromstring 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.

Example:2025-03-01T12:03:15.12Z
validatedDateTostring date-time

End date for searching validations.

Example:2025-03-04T15:02:11.4Z
cursorstring

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.

Example:A1F3B5C7D9E2F4A6B8C0D1E3F5A7B9C1D3E5F7A9B2C4D6E8F0A1B3C5D7E9F2A4
sizeinteger

Number of records per page.

Example:100

Response

Successful response

Example response

{
  "results": [
    {
      "validMailbox": "true|false|unknown"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.