How to use Email Domain Check

Checks the domain behind an email address: MX records, SPF and DMARC policies, and whether the address uses a disposable domain, a free mailbox provider or a role mailbox such as info@ or support@. It never contacts the mail server, so it cannot confirm that a mailbox exists.

Send these fields in the JSON body of the request.

No single field is required on its own, but a request with none of them is rejected: provide exactly one of "email" or "domain".

The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.

Each field is described in the API reference.

1 credit per address checked.

You can try it without an account in the free tool. The free tools share a limit per visitor.

From code, send a POST request to https://YOUR_API_HOST/v1/email-domain-check with your API key.

1curl -X POST https://YOUR_API_HOST/v1/email-domain-check \
2  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{"email":"info@example.com"}'

Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.

• A repeat of the same lookup within 7 days is served from your cache and costs 0 credits.
• When the lookup finds nothing it returns found: false and costs 0 credits.
• Invalid input and errors are never charged.
• The API allows 200 requests per 10 seconds per key.