← Docs

MX API

Mail exchange records for a domain.

Mail exchange records for a domain. Each row is a priority and host, sorted the way mailers try them.

Empty mx means no mail exchanger. That is an answer, not an error. Lookups refresh on use. A day-old copy serves immediately while DNS is re-checked.

To check if a domain is free to register, use Domain.

Lookup

GET
api.parseapi.com/mx/{domain}
MX hosts and priorities (empty array if none)
curl "https://api.parseapi.com/mx/gmail.com" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "domain": "gmail.com",
  "mx": [
    {
      "priority": 5,
      "host": "gmail-smtp-in.l.google.com"
    },
    {
      "priority": 10,
      "host": "alt1.gmail-smtp-in.l.google.com"
    },
    // ... 3 more
  ]
}
curl "https://api.parseapi.com/mx/example.com" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "domain": "example.com",
  "mx": []
}

Response fields

domain
Hostname checked
mx
MX list, priority and host (empty if none)

Questions? Email