Skip to main content
GET
List what changed on a watch's source

Authorizations

Authorization
string
header
required

API key issued from the developer dashboard. Pass as Authorization: Bearer vq_key_... (preferred).

Path Parameters

watch_id
string
required

Query Parameters

limit
integer
default:50

Max changes to return.

Required range: 1 <= x <= 200
sinceId
integer | null

Return only changes with an id greater than this. The cursor to build on: ids are a monotonic sequence, so this is exact, immune to clock skew, and cannot drop two changes that share a timestamp. Carry meta.cursor forward from your last page.

Required range: x >= 0
beforeId
integer | null

Return only changes with an id less than this: the cursor for walking BACK through history, where sinceId walks forward into new changes. A newest-first reader needs this one, since paging down a descending list means asking for what sits below the lowest id already held. Pass the smallest id on your last page.

Required range: x >= 0
since
string | null

Return only changes detected strictly after this ISO-8601 timestamp. Coarser than sinceId (a single refresh writes many rows at the same instant, and this drops all of them), but useful when all you kept was the detectedAt off a changes[] item in a webhook body. Prefer that item's id as sinceId where you still have it. Both may be combined.

Example:

"2026-08-07T04:10:00Z"

changeKind
enum<string>[] | null

Filter to these kinds. Repeat the parameter to pass several (?changeKind=added&changeKind=amended). Omit for all three.

Available options:
added,
amended,
removed
order
enum<string>
default:desc

desc (default) is newest first, for showing a recent-activity list. Use asc when catching up from a cursor: walking forward means a page that hits limit leaves the gap at a known end.

Available options:
asc,
desc

Response

What changed, newest first.

Last modified on October 9, 2026