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

# List Notification Templates

`GET /notifications`

Lists the workspace's notification templates. Each carries a name, tags, brand, routing, and its draft or published state.

## Query parameters

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

## Response `200`

- NotificationListResponse
  - `paging` Paging, required
    - `cursor` string, nullable
    - `more` boolean, required
  - `results` union[], required — Notification templates in this workspace.
    - union
      - Notification
        - `created_at` integer, required
        - `updated_at` integer, required
        - `id` string, required
        - `routing` MessageRouting, required
          - `method` 'all' | 'single', required
          - `channels` MessageRoutingChannel[], required
            - union
              - …
        - `tags` NotificationTag
          - `data` NotificationTagData[], required
            - `id` string, required
            - `name` string, required
        - `title` string, nullable
        - `topic_id` string, required
        - `note` string
        - `event_ids` string[], required — Array of event IDs associated with this notification
      - NotificationTemplateSummary — V2 (CDS) template summary returned in list responses.
        - `id` string, required
        - `name` string, required
        - `tags` string[], required
        - `state` 'DRAFT' | 'PUBLISHED', required
        - `created` integer, required — Epoch milliseconds when the template was created.
        - `creator` string, required — User ID of the creator.
        - `updated` integer — Epoch milliseconds of last update.
        - `updater` string — User ID of the last updater.
        - `subscription_topic_id` string — The linked subscription (preference) topic of the published version. Omitted when no topic is linked or the template has never been published.
        - `topic_id` string — Alias of subscription_topic_id, provided under the same name V1 list items use for the linked topic. Always carries the same value as subscription_topic_id.

## Changes

- **2026-07-29** `f76bed79a913` — 2 info
  - api tag `Templates` added
  - api tag `Notification Templates` removed
- **2026-07-20** `d2377425a729` — 2 info
  - added the optional property `results/items/oneOf[subschema #2: NotificationTemplateSummary]/subscription_topic_id` to the response with the `200` status
  - added the optional property `results/items/oneOf[subschema #2: NotificationTemplateSummary]/topic_id` to the response with the `200` status
- **2026-04-14** `3f78581b4e07` — 1 breaking
  - the response property `results/items/oneOf[subschema #1: Notification]/note` became optional for the status `200`
- **2026-04-02** `b3dde9374868` — 9 breaking, 2 warning, 1 info
  - added `#/components/schemas/Notification, #/components/schemas/NotificationTemplateSummary` to the `results/items/` response property `oneOf` list for the response status `200`
  - the `results/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `results/items/created_at` from the response with the `200` status
  - removed the required property `results/items/event_ids` from the response with the `200` status
  - …8 more
- **2025-12-08** `5be11a3b4798` — 1 info
  - added the required property `results/items/event_ids` to the response with the `200` status

[Full 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/cb8586034158/schema)