Validate an email address
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.
bearerAuthAuthorizationBearer <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.
application/json- body
email*stringThe address to check. Sent as typed — validation reports bad syntax rather than rejecting it.
The verdict.
application/json- response
email*stringThe address checked, trimmed.
result*stringdeliverable: 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.
"deliverable""risky""undeliverable""unknown"reason*|Why result is not deliverable; null when it is.
"invalid_syntax""domain_not_found""null_mx""no_mail_server""previously_bounced""dns_unavailable""disposable""random_input""no_mx_record"nulldid_you_mean*|A corrected address when the domain looks like a typo; otherwise null.
checks*curl -X POST 'https://api.emitd.com/v1/validations' \ -H 'Content-Type: application/json' \ -d '{ "email": "jane@gmail.con"}'{ "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" }}