Skip to main content
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.

​
Path parameters

​
id
string
required
The domain id to re-check, for example dom_01HZ8K3M9P.

​
Request

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

​
Response

200 OK — the domain with its freshly re-checked status, per-record verified flags, and authHealth. 
{
  "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 too. You 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.