> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List notifications

> Page through notifications addressed to the authorized member.

Page through notifications addressed to the authorized member.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `notifications:read`.

Ordered newest first by creation time then ID. Uses Raycast offset cursors. Other members’ notifications are not returned.

## Parameters

<ParamField query="status" type="string">
  all (default), unread, or read.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque nextCursor returned by this Raycast collection; do not use a developer API cursor.
</ParamField>

<ParamField query="limit" type="integer">
  Default 50; 1–100.
</ParamField>

## Response

**200** — `data` [notification objects](/api-reference/raycast/models#notifications), `hasMore`, and `nextCursor`.

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "notification_example",
        "type": "task_assigned",
        "category": "assigned",
        "entityType": "task",
        "entityId": "task_example",
        "title": "Task assigned",
        "body": "Prepare kickoff",
        "isRead": false,
        "readAt": null,
        "createdAt": "2026-09-07T12:00:00.000Z",
        "actor": null,
        "webUrl": "https://app.getkato.io/northlane/tasks/task_example/details"
      }
    ],
    "hasMore": false,
    "nextCursor": null
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error --get \
    "https://api.getkato.io/v1/raycast/notifications" \
    -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN" \
    --data-urlencode "status=unread" \
    --data-urlencode "limit=50"
  ```
</RequestExample>


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [Raycast response models](/api-reference/raycast/models.md)
- [Dismiss a read notification](/api-reference/raycast/notifications-dismiss.md)
- [Mark notification read](/api-reference/raycast/notifications-read.md)
- [Mark notification unread](/api-reference/raycast/notifications-unread.md)