INinfobip
channels
email
email-validation

Validate email address

This method lets you request validation of a single email address in real-time, helping you to identify and remove poor-quality emails from your list.

post/email/2/validation

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

Request body

tostring required

The email address to be validated.

Response

Successful response

tostring required

The validated email address.

validMailboxstring required

Indicates whether email address is valid.

validSyntaxboolean required

Indicates whether email address syntax is valid.

catchAllboolean required

Indicates catch all status of email address.

didYouMeanstring

Suggests similar alternate address that may be valid.

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

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

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

detailedReasonsstring

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.

Changes

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