---
title: "List Notification Template Versions"
method: GET
path: "/notifications/{id}/versions"
tags: ["Templates"]
---

# List Notification Template Versions

`GET /notifications/{id}/versions`

Returns a notification template's published versions, most recent first, for comparison or rollback. Paged.

## Path parameters

- `id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

- NotificationTemplateVersionListResponse
  - `versions` VersionNode[], required
    - `version` string, required — Version identifier. One of "draft", "published:vNNN" (current published version), or "vNNN" (historical version).
    - `created` integer, required — Epoch milliseconds when this version was created.
    - `creator` string, required — User ID of the version creator.
    - `has_changes` boolean — Whether the draft has unpublished changes. Only present on the draft version.
  - `paging` Paging, required
    - `cursor` string, nullable
    - `more` boolean, required

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[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)