Domainee Docs
DNS Checks

Check records match exactly

POST /v1/dns/check-records-match-exactly — DNS lookup with strict "no other values" semantics.

POST /v1/dns/check-records-match-exactly

Same request shape as Check records exist, with stricter rules: returns match: true only if every value DNS returned equals match_against.

Useful when the customer must point ONLY at us — for example, they shouldn't also have an A record alongside the CNAME we asked for.

Request

curl -X POST https://api.domainee.dev/v1/dns/check-records-match-exactly \
  -H "Authorization: Bearer $DOMAINEE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "records": [
      {
        "address": "shop.acme.com",
        "type": "cname",
        "match_against": "edge.domainee.dev"
      }
    ]
  }'

Body parameters

Same as Check records exist.

Response — 200 OK

{
  "records": [
    {
      "address": "shop.acme.com",
      "type": "cname",
      "match_against": "edge.domainee.dev",
      "match": true,
      "actual_values": ["edge.domainee.dev"]
    }
  ]
}

match is false if DNS returned anything that doesn't equal match_against, even if match_against was also in the result set.

Rate limit

600/hour per workspace. See Rate limits. Batch up to 50 checks per call.

On this page