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#
| Field | Type | Description |
|---|---|---|
| domain | string | Normalised domain (IDN converted to punycode). |
| mx | present | absent | unknown | Whether the domain publishes mail-routing records. unknown means DNS did not answer in time. |
| mx_hosts | string[] | Mail hosts in priority order. |
| provider | string | null | google, microsoft, yahoo, icloud, zoho, proton, fastmail, mimecast, proofpoint, barracuda, cisco, other, or null with no MX. |
| gateway | boolean | Sits behind a secure email gateway. |
| disposable | boolean | In the maintained disposable-provider dataset. |
| free_provider | boolean | A consumer mailbox provider such as gmail.com. |
Related