API Almanac

Resolve a DNS record (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV) via DNS over HTTPS

GET/v1/dns

GET/v1/dns

Resolve a DNS record (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV) via DNS over HTTPS

PARAMETERS
namequery · stringREQUIRED
Hostname to resolve
e.g. cloudflare.com
typequery · enum
Record type
one of: A, AAAA, MX, TXT, NS, CNAME, SOA, CAA, SRV, PTR, HTTPS
In the full reference
REQUEST
curl "https://api.apialmanac.com/v1/dns?name=cloudflare.com" \
  -H "X-API-Key: YOUR_KEY"
RESPONSE
200OK
{
  "name": "cloudflare.com",
  "type": "MX",
  "status": "NOERROR",
  "dnssec_validated": true,
  "answers": [
    {
      "name": "cloudflare.com",
      "type": "MX",
      "ttl": 300,
      "data": {
        "preference": 10,
        "exchange": "mailstream-east.mxrecord.io"
      }
    },
    {
      "name": "cloudflare.com",
      "type": "MX",
      "ttl": 300,
      "data": {
        "preference": 20,
        "exchange": "mailstream-central.mxrecord.mx"
      }
    }
  ],
  "authority": []
}
Try it — sign in first
Runs on a sandbox key: 200 requests a month. Your real key is for production.