List watch runs
Returns the watch’s runs, newest first, with cursor pagination. Works for both watch kinds. The
read paths drop the search/ segment that discovery create and manage use, so a discovery watch
created at /watch/job/search reads its runs at /watch/job/{watch_id}/runs.
Each run carries five counters, and each one means something different per watch kind. Read
records_searched as what the run started from, records_after_filter as what was new, and
new_records_count as what was delivered. records_matched is set on an entity run only, and
records_stale on a discovery run only; the other is null. A run that finished before these
two counters shipped carries null for both.
Check notification_http_status before concluding that a quiet channel means nothing happened:
a non-2xx there means the run found matches and the delivery itself was rejected. Pass
only_credited=true to see only the runs that actually charged you.
Authorizations
API key passed as a Bearer token in the Authorization header.
Headers
API version to use. 2025-11-01 is the only accepted value. Send it on every call: it is
enforced today on POST /watch/{dataset}/search, where a missing or unrecognized value returns
400, and the other watch routes accept a request without it rather than relying on that.
2025-11-01 "2025-11-01"
Path Parameters
The dataset the watch is built on.
person, company, job, social_post "person"
The watch's id, returned when it was created.
46936
Query Parameters
Runs per page.
1 <= x <= 100020
The next_cursor from the previous page. Runs with an id below this are returned.
54811
Return only runs that deducted credits.
false

