---
title: "Validate email address"
method: POST
path: "/email/2/validation"
tags: ["channels", "email", "email-validation"]
---

# Validate email address

`POST /email/2/validation`

## 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/validation`
- 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 request validation of a single email address in real-time,
helping you to identify and remove poor-quality emails from your list.

## Request body

- 45c843446703ba5f4438a6f721c629420452796de20bd3dd9adfccde3ed2ffffValidationRequest: Validation request
  - `to` string, required: The email address to be validated.

## Response `200`

Successful response

- 45c843446703ba5f4438a6f721c629420452796de20bd3dd9adfccde3ed2ffffValidationResponse: Validation response
  - `to` 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.
  - `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.
  - `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.

## Other responses

- `400`: Bad request response
- `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)