---
title: "Validate a single email address"
method: POST
path: "/email_validations"
tags: ["Email Validations"]
---

# Validate a single email address

`POST /email_validations`

Validates a single email address and returns deliverability checks.

## Headers

- `Idempotency-Key` string

## Request body

- CreateEmailValidationRequest
  - `email` string, required — Email address to validate. Any non-empty string is accepted; invalid syntax returns valid=false rather than a request error.

## Response `200`

Email validation result.

- EmailValidationResponse
  - `data` EmailValidation, required
    - `checks` EmailValidationChecks, required
      - `disposable` EmailValidationCheck, required
        - `details` string — Human-readable check detail. Omitted when nil.
        - `pass` boolean, required
      - `mx` EmailValidationCheck, required
        - `details` string — Human-readable check detail. Omitted when nil.
        - `pass` boolean, required
      - `role_based` EmailValidationCheck, required
        - `details` string — Human-readable check detail. Omitted when nil.
        - `pass` boolean, required
      - `syntax` EmailValidationCheck, required
        - `details` string — Human-readable check detail. Omitted when nil.
        - `pass` boolean, required
      - `typo` EmailValidationTypoCheck, required
        - `details` string — Human-readable check detail. Omitted when nil.
        - `pass` boolean, required
        - `suggestion` string — Suggested correction for common typos. Omitted when nil.
    - `did_you_mean` string — Suggested correction for typo. Omitted when nil.
    - `email` string, required
    - `record_type` 'email_validation', required
    - `risk_score` number, float, required
    - `valid` boolean, required

## Other responses

- `400` — Bad Request / Validation Failed (10015). Invalid, duplicate, empty, malformed, or overlong Idempotency-Key headers are rejected by Edge with HTTP 400 and error code 10015.
- `401` — Not authorized (10006).
- `409` — A request with the same Idempotency-Key is still being processed (10036). Retry later with the same key and request.
- `413` — Request body exceeds the 8,000,000-byte limit for this endpoint.
- `422` — The Idempotency-Key was already used for a different request (10027).
- `503` — Service unavailable (10016), including an unavailable upstream dependency or unavailable Edge idempotency protection for a keyed request.

## Changes

- **2026-07-16** `2fb3b617430a` — 12 warning, 6 info
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `400`
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `409`
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `413`
  - …14 more
- **2026-07-14** `021f0faf96df` — 1 breaking, 1 warning
  - for the `header` request parameter `Idempotency-Key`, the maxLength was decreased from `512` to `255`
  - changed the pattern of the `header` request parameter `Idempotency-Key` from `^(?:[A-Za-z0-9_-]{1,255}|"(?:[\x20-\x21\x23-\x5B\x5D-\x7E]|\\["\\]){1,255}")$` to `^[A-Za-z0-9_-]{1,255}$`
- **2026-07-12** `b3c5aebde44c` — 4 warning, 5 info
  - added the new `10027` enum value to the `errors/items/code` response property for the response status `400`
  - added the new `10027` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `10036` enum value to the `errors/items/code` response property for the response status `400`
  - added the new `10036` enum value to the `errors/items/code` response property for the response status `401`
  - …5 more
- **2026-07-07** `6ef0ae248bf7` — 1 info
  - endpoint added
- …earlier changes not shown

[Full history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/email_validations/post.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)