---
title: "GET /notifications"
method: GET
path: "/notifications"
tags: ["Notification Templates"]
---

# GET /notifications

`GET /notifications`

## Query parameters

- `cursor` string, nullable
- `notes` boolean, nullable

## Response `200`

- NotificationListResponse
  - `paging` Paging, required
    - `cursor` string, nullable
    - `more` boolean, required
  - `results` Notification[], required
    - `created_at` integer, required
    - `updated_at` integer, required
    - `id` string, required
    - `routing` MessageRouting, required
      - `method` 'all' | 'single', required
      - `channels` MessageRoutingChannel[], required
        - union
          - string
          - MessageRouting — recursive
    - `tags` NotificationTag
      - `data` NotificationTagData[], required
        - `id` string, required
        - `name` string, required
    - `title` string, nullable
    - `topic_id` string, required
    - `note` string, required
    - `event_ids` string[], required — Array of event IDs associated with this notification

## Changes

- **2025-12-08** `5be11a3b4798` — 1 info
  - added the required property `results/items/event_ids` to the response with the `200` status
- **2025-10-15** `e67d02739533` — 2 info
  - api tag `Notification Templates` added
  - api tag `Notifications` removed

[Change history](https://skmtc.dev/trycourier/apis/courier/changes/notifications/get.md)

---

[API](https://skmtc.dev/trycourier/apis/courier.md) · [All operations](https://skmtc.dev/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trycourier/courier/revisions/361d17797dff/schema)