API reference

Retrieve a watcher

GET /v1/watchers/{id}

Returns the watcher object with last_snapshot and the last 20 events. A watcher from another account is 404.

Shell

curl https://watcher-api-staging.manwhas.shop/v1/watchers/wch_dhjqcvaqnhrchsnv7gtc -H "Authorization: Bearer $SNAG_KEY"

JSON

{
  "watcher_id": "wch_dhjqcvaqnhrchsnv7gtc",
  "kind": "release",
  "status": "active",
  "schedule": { "every": "1h", "next_run_at": "2026-11-04T20:41:58.130Z", "until": "2026-11-05T19:38:43.902Z" },
  "last_run_at": "2026-11-04T19:38:44.390Z",
  "first_match_at": "2026-11-04T19:38:44.390Z",
  "last_snapshot": {
    "run_at": "2026-11-04T19:38:44.390Z",
    "matched": true,
    "sites": [
      {
        "site": "github.com/nodejs/node",
        "ok": true,
        "blocked": false,
        "outcome": "ok",
        "candidates": 30,
        "fields": [{ "title": "2026-10-28, Version 26.13.0 'Lithium' (LTS)", "version": 26, "release_status": "available", "release_date": "2026-10-28T15:12:09Z" }],
        "issues": []
      }
    ]
  },
  "events": [{ "id": "evt_4m2k9q8x7c1v0b3n5z6w", "type": "matched", "created_at": "2026-11-04T19:38:44.390Z", "data": { "group": "site:github.com/nodejs/node" } }]
}