---
title: "List Templates Endpoint"
method: GET
path: "/api/v1/remy/templates"
tags: ["remy", "remy"]
---

# List Templates Endpoint

`GET /api/v1/remy/templates`

Every global template plus this user's own, paginated.

## Query parameters

- `scope` 'global' | 'user' | 'both'
- `category` 'funny' | 'casual' | 'professional' | 'formal' | 'friendly' | 'enthusiastic' | 'direct' | 'flattering' | 'playful' | 'persuasive' | 'personalized' | 'concise' | 'storytelling' | 'luxury' | 'bold' | 'empathetic' | 'curious' | 'urgent' | 'minimal' | 'other'
- `search` string, nullable — Template name substring, case-insensitive.
- `page` integer
- `size` integer

## Response `200`

Successful Response

- PageTemplateDTO
  - `items` TemplateDTO[], required
    - `id` string, required
    - `scope` string, required
    - `user_id` string, nullable
    - `kind` string, required
    - `category` string, nullable
    - `name` string, required
    - `data` object, required
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `total` integer, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/624917d53409/schema)