# Listar plantillas (/es/api-reference/templates/listTemplates)

`GET /v1/templates`

Base URL: `https://api.bitelio.com`

Obtiene una lista paginada de plantillas de correo

---

**Versionado de rutas.** Este recurso también responde en `/templates`, sin versionar, que es donde siempre ha estado y donde seguirá funcionando indefinidamente — `bitelio@0.1.0` llama ahí. Usa `/v1/templates`: el prefijo `/v1` es el que lleva una promesa de versión detrás, y un futuro `/v2` podrá cambiar de forma sin romper nada escrito contra este.

## Query parameters

- `limit`: integer — Número máximo de elementos por página
- `cursor`: string — Cursor de paginación
- `type`: enum ("TRANSACTIONAL" | "MARKETING")
- `search`: string

## Responses

### `200` — Lista de plantillas

- `templates`: array<object>
  items:
    - `id`: string
    - `name`: string
    - `subject`: string
    - `body`: string
    - `type`: enum ("TRANSACTIONAL" | "MARKETING")
    - `createdAt`: string (date-time)
- `total`: integer
- `page`: integer
- `pageSize`: integer
- `totalPages`: integer

```json
{
  "templates": [
    {
      "id": "string",
      "name": "string",
      "subject": "string",
      "body": "string",
      "type": "TRANSACTIONAL",
      "createdAt": "2026-10-13T07:11:40.120Z"
    }
  ],
  "total": 0,
  "page": 0,
  "pageSize": 0,
  "totalPages": 0
}
```

## Example request

```bash
curl -X GET 'https://api.bitelio.com/v1/templates' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```