List notifications | CAIL Health

{
  "data": [
    {
      "id": "e9f8d7c6-b5a4-4392-81b0-c9d8e7f6a5b4",
      "category": "alert.threshold_breach",
      "sentAt": "2026-05-13T14:21:00.000Z",
      "isRead": false,
      "payload": {
        "alertRuleId": "1d7d4e29-3b8e-4a01-a4f1-7e2a5b8c1d6e",
        "kpi": "a_and_e_diversion_rate",
        "value": 0.42
      }
    },
    {
      "id": "not_02HZX9P3Q5R7S9T1V3W5Y7Z9A1",
      "category": "system.pathway_deprecated",
      "sentAt": "2026-05-12T08:00:00.000Z",
      "isRead": true,
      "payload": {
        "planDefinitionId": "a1b2c3d4-e5f6-4789-9abc-def012345678"
      }
    }
  ],
  "pagination": {
    "cursor": null,
    "hasMore": false,
    "limit": 20
  }
}

Returns the persistent notification log for the operator, ordered by sentAt descending by default. Filter by category, delivery status, or read-state. Use the cursor returned in pagination.cursor to step through pages. For real-time delivery, subscribe to the SSE stream endpoint instead of polling.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

cursorstringOptional

Opaque cursor returned from a prior call.

limitdoubleOptional1-100

Maximum number of results to return. Defaults to 20.

sortBystringOptional

Sort field. Defaults to sentAt.

sortOrderenumOptional

Sort order. Defaults to desc.

Allowed values:

categorystringOptional

Filter by notification category (e.g., alert.threshold_breach).

statusenumOptional

Filter by delivery lifecycle status.

Allowed values:

unreadbooleanOptional

When true, return only unread notifications.

Response

A cursor-paginated page of notifications.

datalist of objects

Notifications for this page, ordered by sentAt descending by default.

paginationobject

Cursor metadata for paging forward.

$	curl https://staging.cail.health/v1/notifications \
>	-H "Authorization: Bearer <token>"