Domain lookup

Inspect a domain's mail setup without verifying an address. Free.

Request#

GET/v1/domain?name=example.comfree

Returns the domain's MX state, the mail provider behind it, and whether it is a gateway, a disposable provider or a free mailbox provider. No credits are charged; it needs an API key and counts toward the rate limit. Answers come from the same 24-hour domain cache as verification.

Example
curl https://app.veridock.io/v1/domain?name=example.com \
  -H "Authorization: Bearer vd_live_…"

Response#

FieldTypeDescription
domainstringNormalised domain (IDN converted to punycode).
mxpresent | absent | unknownWhether the domain publishes mail-routing records. unknown means DNS did not answer in time.
mx_hostsstring[]Mail hosts in priority order.
providerstring | nullgoogle, microsoft, yahoo, icloud, zoho, proton, fastmail, mimecast, proofpoint, barracuda, cisco, other, or null with no MX.
gatewaybooleanSits behind a secure email gateway.
disposablebooleanIn the maintained disposable-provider dataset.
free_providerbooleanA consumer mailbox provider such as gmail.com.

Related