Skip to content
Gridlode
Docs · Reference

Email Checker

GET /v1/contacts/email-check1 credit / requestcache 1440 min

Deliverability checks without contacting the mailbox: syntax, normalized address, whether the domain exists, its mail servers (MX, sorted by priority) and null-MX policy, plus disposable-domain, role-account (info@, sales@) and free-provider flags and a suggestion for common typos such as gmial.com. Returns a verdict (deliverable_unknown, risky or undeliverable) with reasons. The mailbox itself is never probed over SMTP, so "deliverable_unknown" means the address looks fine but is not confirmed.

Query parameters

email
string · required
Email address to check, e.g. [email protected].
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/contacts/email-check?email=info%40python.org" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Email Checker API page.