---
title: "Get template layers"
method: GET
path: "/v1/templates/{template_id}/layers"
tags: ["Templates"]
---

# Get template layers

`GET /v1/templates/{template_id}/layers`

List the addressable layers of a template.

**Authentication:** API Key required (`x-api-key` header) or JWT token

**Usage:** The image API (`/v1/image/create`) targets elements by layer name via
its `modifications` array. This endpoint returns every named layer of the
template — the counterpart of `/fields` for `{{ }}` variables — so a caller
(or an agent) can discover what is modifiable without opening the editor.

**The reserved `background` layer** is always present: every image template
has a background slot, whether it is an explicit element or the page itself.

**No credits consumed:** This is a read-only endpoint.

**Rate Limits:** 60 requests/min (free), 120 requests/min (paid). Headers included in response.

## Path parameters

- `template_id` string, required — Template short ID (12 characters)

## Response `200`

List of template layers

- TemplateLayersResponse — Response for template layers endpoint
  - `layers` TemplateLayer[], required
    - `name` string, required — Layer name — the value to use in `modifications[].name`
    - `tag` string, required — HTML tag of the element
    - `type` string, required — Layer type: `background`, `image`, `text` or `shape`
    - `current_text` string, nullable — Current text content of the layer (text layers only, truncated)
    - `modifiable` string[], required — Modification fields that apply to this layer
  - `warnings` string[] — Non-fatal issues (e.g. duplicate layer names)

## Other responses

- `403` — Invalid or missing API key
- `404` — Template not found
- `422` — Validation Error

---

[API](https://skmtc.net/pdftemplateapi/apis/templatefox-api.md) · [All operations](https://skmtc.net/pdftemplateapi/apis/templatefox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pdftemplateapi/templatefox-api/revisions/5673fc0d5fad/schema)