Probe a domain's mail exchangers over live SMTP

GET


          /api/v1/email/mx-probe

Try it

R Read

Scope read:email

Description

Resolves the MX set for domain (any public domain — no ownership needed) and connects to each exchanger: exchanges[] of {host, priority, ip, connected, banner, starttls, ptr, fcrdns}, plus delivery-breaking alerts[], informational warnings[] and an overall ok. This is the connection-level check — for the DNS-side spf/dkim/dmarc verdict on a domain you own use check_email_deliverability.

Query parameters

Name	Type	Description
`domain` required	string	The domain whose mail exchangers to probe, e.g. `example.com`.

Responses

The specification does not describe this response body; the note in the rail says what to expect. Every non-2xx response is an RFC 7807 problem with a stable code.

Commonly returned errors

The codes this operation reaches on its own path: the auth stack, its own validation and ownership checks, and the transport. Not a closed set — a shared code from the full registry can still surface. Each links to the code’s own page, the same URL its type dereferences to.

401 No token was presented, or the token is revoked, expired or unknown.

unauthorizedtoken_expiredtoken_revoked

403 The token lacks a required scope, or this account does not own the resource.

insufficient_scope

422 Validation error

validation_failed

429 The rate limit for this token is exhausted. See `Retry-After`.

rate_limited

500 Something went wrong on our side. The failure is logged against `requestId`.

internal_error