---
title: "List templates"
method: GET
path: "/templates"
tags: ["Catalog"]
---

# List templates

`GET /templates`

## Request

- Base URL: `https://app.vern.so/api/v1`
- URL: `https://app.vern.so/api/v1/templates`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/vern-so/apis/vern-api/docs/templates/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the active templates in your account — the importable objects, each with its columns and validation rules. Templates are addressed by **slug**.

## Response `200`

The active templates in your account.

- object
  - `templates` Template[]
    - `slug` string: Stable public identifier.
    - `name` string
    - `description` string, nullable
    - `columns` TemplateColumn[]
      - `name` string
      - `description` string: What the column holds. At most 500 characters for a new or changed value.
      - `required` boolean
      - `unique` boolean
      - `desiredRule` 'none' | 'ai' | 'strict' | 'link'
      - `strictRule` string: Regex the value must match (when desiredRule is strict).
      - `linkRule` object[]: Cross-template references (when desiredRule is link).
        - `templateId` string
        - `columnName` string

## Other responses

- `401`: API key missing, malformed, or revoked.
- `429`: Rate limit hit. Counted per account, not per API key. Creating a migration and starting a `generate` run are limited to 30/hour each; answering a run is limited to 30/hour; reads allow 30/minute and writes 30/minute. `Retry-After` gives the seconds until the window resets, alongside `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`.

## Changes

- **2026-10-22** `5366d630afe8`: 1 breaking
  - the `templates/items/columns/items/description` response property's maxLength was increased from `200` to `500` for the response status `200`
- **2026-06-18** `c5a09eb23a64`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vern-so/apis/vern-api/changes/templates/get.md)

---

[API](https://skmtc.dev/vern-so/apis/vern-api.md) - [All operations](https://skmtc.dev/vern-so/apis/vern-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vern-so/apis/vern-api/revisions/6ae61af2db81?raw)