---
title: "Submits an email address to the service to be validated and returns the result of the validation."
method: POST
path: "/email/validation/v1"
tags: ["Email Validation"]
---

# Submits an email address to the service to be validated and returns the result of the validation.

`POST /email/validation/v1`

## Headers

- `Reference-Id` string

## Request body

- EmailValidationV1Request — The request model.
  - `email` string, required — The email address that is the subject of the validation.
  - `timeout` integer — Maximum time you are prepared to wait for a response, expressed in seconds. Acceptable values: 3-15. If a timeout occurs, a confidence status of "unknown" and a verbose result of "timeout" will be returned.

## Response `200`

OK

- EmailValidationV1Response — The response model.
  - `reference_id` string, nullable — If you chose to submit a "Reference-Id" in the response body, the value will be returned with the response.
  - `transaction_id` string, nullable — Unique Experian-assigned transaction identifier.
  - `error` ResponseError — Error model containing the error details.
    - `type` string, nullable — A link to documentation that provides more details about the error you’ve encountered.
    - `title` string, nullable — The title of the error.
    - `detail` string, nullable — A description of the error.
    - `instance` string, nullable — The endpoint that returned the error.
  - `result` EmailValidationV1Result — Details about the result. Includes the validated data and its confidence level.
    - `email` string, nullable — The email address that is the subject of the validation.
    - `confidence` 'verified' | 'undeliverable' | 'unreachable' | 'illegitimate' | 'disposable' | 'unknown' — The outcome (confidence level) of the validation.
    - `verbose` string, nullable — Additional information on the confidence level.
    - `corrections` string[], nullable — A list of more likely email addresses. Suggestions include fixes to syntax errors in the provided email address, typos in domains etc.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `406` — Not Acceptable
- `408` — Request Timeout
- `415` — Unsupported Media Type
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/experianaperture/apis/aperture-rest-api.md) · [All operations](https://skmtc.dev/experianaperture/apis/aperture-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/experianaperture/aperture-rest-api/revisions/f17d329b4892/schema)