List watches (the Watchlist)

Free. Everything this key keeps watch on — areas under satellite measurement, areas under event watch, and real-world events being tracked — aggregated as one list. Each watch carries a state bucket (needs_attention / changed_today / awaiting_data / stable), its capabilities (measurements, standing-order questions, event state), and the latest meaningful change. A monitored metric and a standing order on the same bbox appear as ONE watch. Also returns the active-watch plan limit. Pass updated_since to receive only the watches whose CONTENT changed after that instant — a new measurement, a new note, a new development, not merely a rename — which is what a system holding a synchronised copy should poll; bucket counts and plan limits still describe the whole watchlist, never the returned page.

get/api/v1/watches

Request

  • Base URL: https://offnadir-delta.com
  • URL: https://offnadir-delta.com/api/v1/watches
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

updated_sincestring date-time

ISO 8601 instant. Return only watches whose content changed after it. This tracks every table that contributes to a watch (measurements, notes, notifications, bindings), not just edits to the watch row, so a quiet result really means nothing changed rather than nothing was edited.

cursorstring

Opaque pagination cursor from a previous response's meta.next_cursor. Bound to the query that produced it — a cursor from a different updated_since is rejected rather than silently returning overlapping rows.

limitinteger

Watches per page when paging (1..500, default 100).

Response

Your watches, bucket counts, and the plan limit for active watches.

watchesobject[]
bucketsobject

Changes

No recorded changes to this operation across all 1 revision of this API.