---
title: "List templates"
method: GET
path: "/documents/templates/"
tags: ["Guided Templates"]
---

# List templates

`GET /documents/templates/`

Returns a list of templates and their metadata. Fetch a specific templateId to get the expanded sections.
Use query parameters to filter by language, region, specialty, label, publish status, or source.

## Query parameters

- `lang` string[]
- `region` string[]
- `specialty` string[]
- `label` string[]
- `published` boolean
- `source` 'user' | 'corti' — Filter by content source.

## Headers

- `Tenant-Name` string, required — Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

## Response `200`

OK

- GuidedTemplateListItem[]
  - `id` string, uuid, required — The UUID of the template.
  - `inheritedFromId` string, uuid, nullable — Reference to the template to inherit template instructions and sections from. Inherits from published version by default.
  - `autoGenerated` boolean — True if the template was auto-generated based on the section-composed POST /documents request.
  - `source` 'user' | 'corti' | 'project' — Whether this template was created by the user, a project-related API Client or is a Corti standard resource.
  - `name` string, required — The name of this template. Not passed to the LLM.
  - `description` string — A description for this template. Not passed to the LLM.
  - `languages` string[], required — BCP 47 language tags this template has been tweaked for (e.g. `["fr", "de", "en-GB"]`). Empty means no language-specific tweaks.
  - `regions` string[], required — ISO 3166-1 alpha-3 country codes this template has been tweaked for (e.g. `["BEL"]`). Empty means no region-specific tweaks.
  - `specialties` string[], required — Clinical specialties this template has been tweaked for. Empty means no specialty-specific tweaks.
  - `labels` GuidedLabel[], required — The available labels to use as query param filter in the LIST /templates endpoint.
    - `key` string, required
    - `value` string, required
  - `createdBy` string, uuid — The UUID of the creator of this template.
  - `createdAt` string, date-time, required — The original timestamp when the template was created.
  - `updatedAt` string, date-time, required — The original timestamp when the template was last updated.
  - `deletedAt` string, date-time, nullable — Present when the template has been deleted. GET by ID still returns the full resource with this field populated.

---

[API](https://skmtc.net/corti/apis/admin-api.md) · [All operations](https://skmtc.net/corti/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corti/admin-api/revisions/5d1895a1b3fc/schema)