---
title: "List all notifications"
method: GET
path: "/notifications"
---

# List all notifications

`GET /notifications`

Lists all notifications for a user.

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string
- `status` string
- `category` string
- `topic` string

## Response `200`

OK

- NotificationCollection
  - `data` Notification[]
    - `action_url` string, nullable — The link associated with the notification.
    - `archived_at` string, date-time, nullable — The timestamp when the notification was archived.
    - `category` string, nullable — The category grouping for the notification.
    - `content` string, nullable — The body content of the notification.
    - `created_at` string, date-time, required — The timestamp when the notification was created.
    - `custom_attributes` object, nullable — The custom data stored with the notification.
    - `discarded_at` string, date-time, nullable — The timestamp when the notification was discarded.
    - `id` string, uuid, required — The unique identifier for the notification.
    - `read_at` string, date-time, nullable — The timestamp when the notification was marked as read.
    - `seen_at` string, date-time, nullable — The timestamp when the notification was seen.
    - `sent_at` string, date-time, nullable — The timestamp when the notification was sent.
    - `status` 'unseen' | 'unread' | 'read' | 'archived', required — The current status of the notification.
    - `title` string, required — The title that is displayed to recipients.
    - `topic` string, nullable — The topic for additional classification.
    - `updated_at` string, date-time, required — The timestamp when the notification was last updated.
    - `user_id` string, uuid, required — The user that should receive the notification.
  - `links` Links
    - `first` string
    - `next` string, nullable
    - `prev` string, nullable

---

[API](https://skmtc.net/magicbell/apis/magicbell-api.md) · [All operations](https://skmtc.net/magicbell/apis/magicbell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magicbell/magicbell-api/revisions/8b99dca11019/schema)