---
title: "Listar templates"
method: GET
path: "/v1/templates"
tags: ["Templates"]
---

# Listar templates

`GET /v1/templates`

Lista mensagens rápidas (templates) do workspace. Filtros: type, status Meta, paginação. Para envio use `POST /v1/send/template`.

## Query parameters

- `type` 'conversation' | 'imageMessage' | 'videoMessage' | 'audioMessage' | 'documentMessage' | 'button'
- `status` 'APPROVED' | 'PENDING' | 'REJECTED'
- `page` number
- `limit` number

## Response `200`

Lista de templates

- TemplatesListResponseDto
  - `templates` TemplateResponseDto[], required
    - `id` string, uuid, required
    - `type` 'conversation' | 'imageMessage' | 'videoMessage' | 'audioMessage' | 'documentMessage' | 'button', nullable
    - `trigger` string, nullable — Atalho / trigger no chat
    - `content` string, nullable
    - `caption` string, nullable
    - `fileUrl` string, nullable — URL da mídia
    - `fileName` string, nullable
    - `metaName` string, nullable — Nome do template na Meta (WABA)
    - `metaStatus` 'APPROVED' | 'PENDING' | 'REJECTED', nullable — Status Meta derivado do primeiro item de metadata
    - `hasVariables` boolean, required — Se content/caption contém placeholders {{…}}
    - `variableCount` number, required — Quantidade de placeholders (mapeados para var1..varN)
    - `metaComponents` object, nullable — Componentes de botão (quando type=button)
    - `metadata` TemplateMetadataItemDto[] — Metadados Meta por WABA (detalhe)
      - `status` string — Status Meta
      - `category` string — Categoria Meta
      - `language` string — Idioma
      - `waba` string — WABA id
      - `id` string — Template id na Meta
  - `pagination` TemplatesPaginationDto, required
    - `page` number, required
    - `limit` number, required
    - `total` number, required
    - `totalPages` number, required
    - `hasNextPage` boolean, required
    - `hasPreviousPage` boolean, required

## Other responses

- `401` — Não autorizado — chave de empresa inválida ou ausente

---

[API](https://skmtc.dev/liderhub/apis/api-liderhub.md) · [All operations](https://skmtc.dev/liderhub/apis/api-liderhub/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liderhub/api-liderhub/revisions/cce9b43211ac/schema)