---
title: "Poll Watch"
method: GET
path: "/watch/{watch_id}"
tags: ["watch"]
---

# Poll Watch

`GET /watch/{watch_id}`

## Request

- Base URL: `https://dnsdoctor.dev/api/v1`
- URL: `https://dnsdoctor.dev/api/v1/watch/{watch_id}`
- Auth: none required

Read one bought watch. Free, per-handle rate-limited, 404 on anything else.

`before` pages backwards through the observations (newest first, 50 a page);
the response's `next_before` is non-null exactly when older ones remain.

## Path parameters

- `watch_id` string, required

## Query parameters

- `before` string, nullable

## Response `200`

Successful Response

- WatchStatus: A watch's state and everything observed so far. Deterministic throughout, and a **relay**: `verdict` is the verdict the last observation was recorded with, never re-derived here — the runner writes it from D94's own `derive_verdict`, so the poll surface cannot drift from the on-demand check's rules (a faulted probe is an unreached vantage, never a negative reading, and fewer than three contributing vantage points degrade the verdict to `unknown`). `observations` are relayed verbatim as the runner recorded them, minus the `_`-prefixed internal state `observation_page` strips. No prose, no composed record, no prescription-shaped field at any depth — the D94 invariant carries onto every watch surface.
  - `kind` string, required
  - `target` string, required
  - `state` string, required
  - `params` object, required
  - `created_at` string, required
  - `expires_at` string, required
  - `results_expire_at` string, required
  - `last_checked_at` string, nullable, required
  - `checks` integer, required
  - `verdict` string, nullable, required
  - `observations` object[], required
  - `next_before` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dnsdoctor/apis/dns-doctor-api.md) · [All operations](https://skmtc.dev/dnsdoctor/apis/dns-doctor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dnsdoctor/apis/dns-doctor-api/revisions/1d0114806e76?raw)