---
title: "Get Template"
method: GET
path: "/v3/templates/{template_id}"
tags: ["Templates"]
---

# Get Template

`GET /v3/templates/{template_id}`

Returns template details including its variable schema (with current default values) and scenes. Variable defaults are returned in the same shape the generate request accepts, so a response can be edited and posted back. Only draft version 4 templates (the current editor format) are supported.

## Path parameters

- `template_id` string, required

## Response `200`

Successful response

- object
  - `data` TemplateDetailV3 — Template detail including its variable schema and scenes.
    - `id` string, required — Unique template identifier
    - `name` string, required — Template name
    - `thumbnail_url` string, nullable — URL to the template thumbnail image
    - `aspect_ratio` string, nullable — Template aspect ratio
    - `created_at` integer, nullable — Unix timestamp of creation
    - `updated_at` integer, nullable — Unix timestamp of last update
    - `variables` object — Variables defined in the template with their current default values, keyed by variable name
    - `scene_ids` string[] — Scene IDs in template order
    - `scenes` TemplateSceneV3[] — Scenes defined in the template
      - `scene_id` string, required — Scene ID, usable in the generate request's scene_ids
      - `script` string, nullable — Scene script text, with variable placeholders unreplaced
      - `variables` TemplateSceneVariableRef[] — Variables used in this scene
        - `name` string, required — Variable name, matching a key in the template's variables
        - `variable_type` string, required — Variable type: text, image, video, audio, character, or voice

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `404` — Resource not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/heygen/apis/heygen-external-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-external-api/versions/e2e54726e210/schema)