API reference

List watchers

GET /v1/watchers

Query
`status`	`active`, `paused`, `matched` or `expired`
`kind`	`price`, `availability`, `release` or `mixed`
`limit`	1 to 100. Default 25
`cursor`	`next_cursor` from the previous page

Shell

curl "https://watcher-api-staging.manwhas.shop/v1/watchers?status=active&limit=2" -H "Authorization: Bearer $SNAG_KEY"

JSON

{
  "data": [
    { "watcher_id": "wch_dhjqcvaqnhrchsnv7gtc", "kind": "release", "status": "active", "schedule": { "every": "1h", "next_run_at": "2026-11-04T20:41:58.130Z" } },
    { "watcher_id": "wch_7r3t5y8u2i4o6p1a9s0d", "kind": "price", "status": "active", "schedule": { "every": "6h", "next_run_at": "2026-11-05T01:02:11.551Z" } }
  ],
  "next_cursor": "MjAyNi0xMS0wNFQxOTozODo0My45MDJa"
}

Each item is a watcher object without events. next_cursor is null on the last page.