---
title: "List Caption Templates"
method: GET
path: "/v1/videos/captions/templates"
tags: ["Video Captions"]
---

# List Caption Templates

`GET /v1/videos/captions/templates`

List available caption style templates.

Returns a paginated list of templates that can be used when creating captioned videos.

## Query parameters

- `limit` integer — Max number of items to return
- `after` string, nullable — Return items strictly after this template ID

## Headers

- `x-api-key` string, required — API Key for authentication

## Response `200`

Returns a paginated list of available caption templates

- MACaptionTemplateList — Paginated list of caption templates
  - `data` MACaptionTemplate[], required — List of caption templates
    - `id` string, required — Unique template identifier
    - `object` 'caption_template'
    - `name` string, required — Human-readable template name
    - `preview_url` string, nullable — URL to a preview video of the template
    - `created_at` integer, required — When the template was created (unix timestamp)
  - `object` 'list'
  - `has_more` boolean, required — Whether there are more templates after this page

## Other responses

- `422` — Validation Error

---

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