Retrieve a domain - Drin

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.

Path parameters

string

required

The domain id, for example dom_01HZ8K3M9P.

Request

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

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

const domain = await drin.domains.get("dom_01HZ8K3M9P");

console.log(domain.status, domain.authHealth);

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.

{
  "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"
}