---
title: "Get a template"
method: GET
path: "/templates/{template_slug}"
tags: ["Catalog"]
---

# Get a template

`GET /templates/{template_slug}`

## Request

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

Fetch one active template by its slug.

## Path parameters

- `template_slug` string, required

## Response `200`

The template.

- 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.
- `404`: The referenced resource isn't in your account.
- `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 `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/:template_slug/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)