> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar templates

> Lista todos os templates criados no projeto com paginação.

Lista todos os templates do seu projeto.

## Parâmetros de query

<ParamField query="page" type="integer">
  Número da página (começa em 1). Padrão: 1.
</ParamField>

<ParamField query="perPage" type="integer">
  Itens por página. Padrão: 10. Máximo: 100.
</ParamField>

## Respostas

<ResponseField name="data" type="array">
  Lista de templates.

  <Expandable title="Propriedades de data[]">
    <ResponseField name="uuid" type="string">
      UUID do template.
    </ResponseField>

    <ResponseField name="title" type="string">
      Título do template.
    </ResponseField>

    <ResponseField name="filename" type="string">
      Nome do arquivo.
    </ResponseField>

    <ResponseField name="pageCount" type="integer">
      Número de páginas.
    </ResponseField>

    <ResponseField name="fieldCount" type="integer">
      Número de campos dinâmicos.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Timestamp de criação (ISO 8601).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="integer">
  Total de templates no projeto.
</ResponseField>

<ResponseField name="page" type="integer">
  Página atual.
</ResponseField>

<ResponseField name="perPage" type="integer">
  Itens por página.
</ResponseField>

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **401**: API key/Bearer token inválido.

<ResponseExample>
  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 200 OK
  Content-Type: application/json

  {
    "data": [
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "title": "Contrato de Serviços",
        "filename": "contrato.pdf",
        "pageCount": 2,
        "fieldCount": 3,
        "createdAt": "2025-07-27T10:30:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "perPage": 10
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X GET "https://signer.vcc-service.com/v1/templates?page=1&perPage=20" \
  -H "x-api-key: YOUR_API_KEY"
```

## Relacionado

* [`GET /v1/templates/:uuid`](/plataforma/assinatura-digital/api/get-template-by-id) — detalhe do template
* [`POST /v1/templates/:uuid/envelopes`](/plataforma/assinatura-digital/api/post-template-envelope) — criar envelope a partir do template