List notifications (the Notification Center)

Free. What changed across your watches, newest first — the same ledger as the bell in the app and the Watch update emails. Each notification names its watch, a one-line statement of the change, and (for an event or a site) the event it points at; a related_event notification carries the newly linked event and whether you already watch it. Values your plan does not open are withheld, not invented: locked is true and lock_plan names the cheapest plan that opens them. unread_count is your total unread, independent of the filters. Page with next_cursor.

get/api/v1/notifications

Request

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

Query parameters

unread_onlyboolean

true returns only notifications not yet marked read.

kind'event_development' | 'related_event' | 'monitoring_anomaly' | 'site_event' | 'new_imagery' | 'standing_order' | 'sequence_incident'

Only this kind of notification.

watch_idstring

Only notifications from this watch (id from GET /api/v1/watches).

cursorstring

Opaque pagination cursor from a previous response's next_cursor.

limitinteger

Notifications per page (1..100, default 20).

Response

Notifications newest first, the unread total, and the next page cursor.

notificationsobject[]
unread_countnumber

Your total unread, regardless of the filters.

next_cursorstring nullable

Changes

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