watch

Create Record Watch

Buy a DNS record watch: one record, read authoritatively, up to 24 hours.

Anonymous; 402 on every call. The propagation create's gate order: inert 503, the 422 on a malformed target, the fleet-wide caps' 429, then the lane — everything that can refuse refuses before any money moves.

post/watch/record

Request

  • Base URL: https://dnsdoctor.dev/api/v1
  • URL: https://dnsdoctor.dev/api/v1/watch/record
  • Auth: none declared

Request body

domainstring required
kindstring required

Which record to watch: spf, dmarc, txt, mx, cname, a or aaaa. The watch reports met when the authoritative answer set differs from the first one recorded — a name whose A/AAAA answers legitimately rotate (an ELB/ALB or GSLB hostname) meets on the rotation, not on your change.

hoststring nullable

A label under the domain (txt, cname, a and aaaa only), e.g. www.

window_hoursnumber

Response

Successful Response

watch_idstring required
kindstring required
targetstring required
record_typestring nullable required
expected_valuestring nullable required
statestring required
cadence_secondsinteger required
window_hoursnumber required
price_usdstring required
created_atstring required
expires_atstring required
results_expire_atstring required
poll_urlstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.