Docs
DashboardGet API key
API · domains

Verify a domain

Force a live DNS re-check now. Unlike retrieve — which returns the last background-polled status — this queries your DNS in the moment and returns the fresh result.

POST/v1/domains/{id}/verify

Call this after publishing the records returned by add domain. DNS can take minutes to hours to propagate; if the domain is still pending, inspect each record's verified flag to see what hasn't resolved yet, then retry. The body is empty.

01 Path parameters

idstringRequired
The domain id to re-check, for example dom_01HZ8K3M9P.

02 Request

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

03 Response

200 OK — the domain with its freshly re-checked status, per-record verified flags, and authHealth.

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
    }
  ],
  "authHealth": { "dkim": "verified", "spf": "verified", "dmarc": "verified" }
}
Verification runs in the background tooYou don't have to poll. Drin re-checks pending domains automatically — calling verify just makes it happen immediately instead of waiting for the next sweep.