---
title: "List all notifications"
method: GET
path: "/notifications"
tags: ["Notifications"]
---

# List all notifications

`GET /notifications`

Retrieve a list of notifications for the authenticated team.

## Query parameters

- `cursor` string, nullable — Cursor for pagination, representing the last item from the previous page
- `pageSize` number — Number of notifications to return per page (1-100)
- `status` union — Filter by notification status. Can be a single status or array of statuses. unread = new notifications, read = viewed but not dismissed, archived = dismissed from view
  - 'unread' | 'read' | 'archived'
  - string[]
- `userId` string, uuid, nullable — Filter notifications by specific user ID
- `priority` integer, nullable — Filter notifications by priority level (1-10)
- `maxPriority` integer, nullable — Filter notifications by maximum priority level (priority <= maxPriority). Use 3 for user-facing notifications only.

## Response `200`

Retrieve a list of notifications for the authenticated team.

- NotificationsResponseSchema
  - `data` NotificationSchema[], required — Array of notifications
    - `id` string, uuid, required — Unique identifier of the notification
    - `createdAt` string, required — ISO timestamp when the notification was created
    - `teamId` string, uuid, required — Unique identifier of the team
    - `userId` string, uuid, nullable, required — Unique identifier of the user (if applicable)
    - `type` string, required — Type of notification
    - `priority` integer, required — Priority level of the notification (1-3 = user notifications, 4-10 = system)
    - `source` 'system' | 'user', required — Source of the notification
    - `status` 'unread' | 'read' | 'archived', required — Current status of the notification
    - `metadata` object, required — Additional metadata for the notification
    - `lastUsedAt` string, nullable, required — ISO timestamp when the notification was last used by the system
  - `meta` object, required — Pagination metadata
    - `cursor` string, nullable, required — Cursor for pagination (null if no more pages)
    - `hasPreviousPage` boolean, required — Whether there are previous pages available
    - `hasNextPage` boolean, required — Whether there are more pages available

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/midday-ai/apis/midday-api.md) · [All operations](https://skmtc.net/midday-ai/apis/midday-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/midday-ai/midday-api/versions/c0df9243c1b0/schema)