---
title: "List Templates in Tenant"
method: GET
path: "/tenants/{tenant_id}/templates"
tags: ["Tenant Templates"]
---

# List Templates in Tenant

`GET /tenants/{tenant_id}/templates`

## Request

- Base URL: `https://api.courier.com`
- URL: `https://api.courier.com/tenants/{tenant_id}/templates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/trycourier/apis/courier/docs/tenants/:tenant_id/templates/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists a tenant's notification templates, each carrying its version and published timestamp. Paged.

## Path parameters

- `tenant_id` string, required

## Query parameters

- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

- ListTemplatesByTenantResponse
  - `items` ListTemplateTenantAssociation[], nullable
    - `id` string, required: The template's id
    - `created_at` string, required: The timestamp at which the template was created
    - `updated_at` string, required: The timestamp at which the template was last updated
    - `published_at` string, required: The timestamp at which the template was published
    - `version` string, required: The version of the template
  - `has_more` boolean, required: Set to true when there are more pages that can be retrieved.
  - `url` string, required: A url that may be used to generate these results.
  - `next_url` string, nullable: A url that may be used to generate fetch the next set of results. Defined only when `has_more` is set to true
  - `cursor` string, nullable: A pointer to the next page of results. Defined only when `has_more` is set to true
  - `type` 'list', required: Always set to `list`. Represents the type of this object.

## Other responses

- `400`

## Changes

- **2026-07-29** `f76bed79a913`: 2 info
  - api tag `Tenant Templates` added
  - api tag `Courier Create` removed
- **2025-10-17** `ef4cd17e3d62`: 2 info
  - api tag `Courier Create` added
  - api tag `Tenants` removed
- **2025-10-07** `7143ea51f307`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trycourier/apis/courier/changes/tenants/:tenant_id/templates/get.md)

---

[API](https://skmtc.dev/trycourier/apis/courier.md) - [All operations](https://skmtc.dev/trycourier/apis/courier/llms.txt) - [OpenAPI document](https://skmtc.dev/trycourier/apis/courier/revisions/cb8586034158?raw)