Skip to Content
Docs
API referenceValidation

Validate an email address

POST
/v1/validations

Checks one address the way emitd checks every recipient before sending: syntax, whether the domain accepts mail (MX, with the A/AAAA fallback), whether the address has hard-bounced before (the cross-account blocklist and your own suppressions — never another account's), and risk signals: role address, disposable domain, random-looking local part. did_you_mean suggests a fix for common provider typos (gmial.com) and slipped TLDs (.con).

Mailboxes are never probed over SMTP, so checks.mailbox is medium unless the address has bounced (low). A malformed address is not an error: it comes back 200 with result: undeliverable and reason: invalid_syntax. Any key that can send may validate. Each workspace gets 1,000 validations per rolling 24 hours.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Request Body

application/json
  1. body
email*string

The address to check. Sent as typed — validation reports bad syntax rather than rejecting it.

Response Body

The verdict.

application/json
  1. response
email*string

The address checked, trimmed.

result*string

deliverable: the domain takes mail and nothing looks risky. risky: deliverable, but disposable, random-looking, or with no MX record. undeliverable: will bounce — bad syntax, no such domain, a null MX, no mail server, or a previous hard bounce. unknown: DNS could not be read just now.

Value in"deliverable""risky""undeliverable""unknown"
reason*|

Why result is not deliverable; null when it is.

Value in"invalid_syntax""domain_not_found""null_mx""no_mail_server""previously_bounced""dns_unavailable""disposable""random_input""no_mx_record"null
did_you_mean*|

A corrected address when the domain looks like a typo; otherwise null.

checks*
Example Request
curl -X POST 'https://api.emitd.com/v1/validations' \  -H 'Content-Type: application/json' \  -d '{  "email": "jane@gmail.con"}'
Example Response
{  "email": "jane@gmail.con",  "result": "undeliverable",  "reason": "domain_not_found",  "did_you_mean": "jane@gmail.com",  "checks": {    "syntax": "high",    "dns": "low",    "mailbox": "medium",    "role": "low",    "disposable": "low",    "random": "low"  }}