Email Validity
Lookups
Email Validity
Dedicated deliverability check for an email address disposable and mailbox verification only, without the full web-profile enrichment.
POST
Email Validity
Authentication
Requires an API key in theAuthorization header.
Request
The email address to validate. The legacy key
e is still accepted.Example request
Response
Returns the four-status deliverability model plus metadata that explains and enriches the verdict (metadata never changes the publicstatus, except a
corroborated catch-all being promoted to valid).
The email address that was checked (normalized to lowercase).
The public verdict one of
valid, invalid, catch-all, or risky.Machine-readable explanation, e.g.
deliverable, syntax, disposable,
null_mx, no_mail_route, hard_reject, mailbox_full, unverifiable,
greylist_unresolved, ip_blocked, unreachable, catch_all, or
catchall_corroborated.Provider-calibrated confidence in the verdict
high, medium, or low
(e.g. a bare 250 from Yahoo/O365 is reported as lower confidence).true when the local part is a role/shared mailbox (e.g. support@,
info@). Role accounts still deliver this is a flag only.A suggested correction when a likely typo is detected (e.g.
gmial.com).The domain part of the address.
Mailbox provider classification
google, microsoft, yahoo, or other.The domain’s resolved mail servers (MX hosts) in preference order.
The domain’s outbound-security posture (non-voting metadata):
grade (A–F),
spf, dmarc, dmarc_policy, mta_sts, and tls_rpt, plus the raw DNS
records behind them (spf_record, dmarc_record, tls_rpt_record,
mta_sts_record) when present.OSINT corroboration:
count of independent hits and the sources that hit
(hibp, gravatar, github, gitlab, pgp). A positive signal on a
catch-all domain promotes the status to valid.Technical probe detail when available:
mx_host, code, message,
catch_all, and greylisted.Legacy mirror of
status, retained for backward compatibility.Example response
The in-app equivalent is
POST /api/email/validity (session-authenticated).
Both charge like a standard lookup. The MCP validate_email tool returns the
same shape and is free.