---
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.

---

[API](https://skmtc.net/trycourier/apis/courier.md) · [All operations](https://skmtc.net/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycourier/courier/versions/04f69fbf96a5/schema)