system

Read-only notification feed (unmetered). Overview = 10 most recent per category; drill-down = next 10 of one category.

get/api/notifications

Request

  • Base URL: https://snowsignals.io/v1
  • URL: https://snowsignals.io/v1/api/notifications
  • Auth: one of:
    • API key in query parameter apiKey
    • API key in header Authorization

Query parameters

category'support' | 'billing'

Omit for the per-category overview; set to drill into one category (with cursor). security and marketing are not readable over the API; see the 400 response.

cursorstring

Opaque pagination cursor from a previous nextCursor (drill-down only).

Response

Without category: an overview object keyed by category, each { rows: Notification[≤10], nextCursor }. With category: a single { rows: Notification[≤10], nextCursor } page. nextCursor is null when no older rows remain. Never marks anything read. Only categories the notification routing matrix permits on the api channel are present. security is NEVER included (an API key is a weaker credential than a session, so account-takeover events are not readable through one) and neither is marketing; a category whose api toggle you have switched off in your notification settings is omitted rather than returned empty.

OR

Example response

{
  "support": {
    "rows": [
      {
        "id": "1287",
        "category": "support",
        "title": "Support replied to your ticket",
        "snippet": "#42 · Cannot log in",
        "link": "/support",
        "createdAt": "2026-07-15T01:22:03.145Z"
      }
    ]
  },
  "billing": {
    "rows": [
      {
        "id": "1287",
        "category": "support",
        "title": "Support replied to your ticket",
        "snippet": "#42 · Cannot log in",
        "link": "/support",
        "createdAt": "2026-07-15T01:22:03.145Z"
      }
    ]
  }
}

Changes

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