---
title: "Get Templates"
method: GET
path: "/api/v1/video/templates"
tags: ["video"]
---

# Get Templates

`GET /api/v1/video/templates`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/video/templates`
- Auth: HTTP bearer

## Query parameters

- `template_type` string[], nullable
- `template_id` string, nullable
- `category` string, nullable
- `category_contains` string, nullable
- `exclude_category_contains` string, nullable
- `limit` integer, nullable
- `offset` integer, nullable

## Response `200`

Successful Response

- GetTemplatesResponseDTO
  - `success` boolean, required
  - `message` string, required
  - `data` VideoTemplateDTO[], required
    - `id` string, required
    - `template_id` string, nullable
    - `template_data` unknown
    - `template_type` string, nullable
    - `preview_url` string, nullable
    - `template_metadata` unknown
    - `category` string, nullable
    - `input_fields` unknown
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
  - `total_count` integer, required
  - `returned_count` integer, required

## Other responses

- `422`: Validation Error

## Changes

> 36 revisions in range; 1 not diffed.

- **2026-10-22** `23eb62d854e6`: 2 info
  - added the new optional `query` request parameter `category_contains`
  - added the new optional `query` request parameter `exclude_category_contains`

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/video/templates/get.md)

---

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