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

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

---

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