Docs
DashboardGet API key
API · domains

Retrieve a domain

Fetch one domain by id — its full DNS records, per-record verified flags, and a deliverability summary across DKIM, SPF, and DMARC.

GET/v1/domains/{id}

This re-reads the last status from the background poller. To force a live DNS re-check right now, call verify instead.

01 Path parameters

idstringRequired
The domain id, for example dom_01HZ8K3M9P.

02 Request

curl https://api.drin.run/v1/domains/dom_01HZ8K3M9P \
  -H "Authorization: Bearer $DRIN_API_KEY"

03 Response

200 OK — the domain. The detail view adds authHealth (each of dkim, spf, and dmarc is verified, pending, or missing) and receivingEnabled. An unknown id returns 404 — see Errors.

JSON
{
  "id": "dom_01HZ8K3M9P",
  "domain": "mail.acme.com",
  "status": "verified",
  "records": [
    {
      "type": "CNAME",
      "name": "abcd1234._domainkey.mail.acme.com",
      "value": "abcd1234.dkim.drin.run",
      "purpose": "dkim",
      "verified": true
    },
    {
      "type": "TXT",
      "name": "mail.acme.com",
      "value": "v=spf1 include:drin.run ~all",
      "purpose": "spf",
      "verified": true
    },
    {
      "type": "TXT",
      "name": "_dmarc.mail.acme.com",
      "value": "v=DMARC1; p=none;",
      "purpose": "dmarc",
      "verified": true
    }
  ],
  "authHealth": { "dkim": "verified", "spf": "verified", "dmarc": "verified" },
  "receivingEnabled": false,
  "createdAt": "2026-05-30T11:04:00Z"
}