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_...

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), but useful when all you kept was the detectedAt from a webhook body. 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 August 23, 2026