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

# List Notification Templates

`GET /notifications`

List notification templates in your workspace.

## 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, required
        - `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.

## Changes

- **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
- **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/f0ac5c2fa86e/schema)