> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.recurrente.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server.

# Paginación

> Cómo funciona la paginación en los endpoints de listado

Los endpoints de listado retornan resultados paginados. Controlas la paginación con parámetros de consulta y lees los metadatos desde los headers de respuesta.

## Parámetros de Consulta

| Parámetro | Por defecto | Descripción          |
| --------- | ----------- | -------------------- |
| `page`    | `1`         | Número de página     |
| `items`   | `20`        | Elementos por página |

## Headers de Respuesta

Los metadatos de paginación siguen el estándar [RFC 8288](https://tools.ietf.org/html/rfc8288):

| Header         | Descripción                                             |
| -------------- | ------------------------------------------------------- |
| `Link`         | Enlaces de navegación (`first`, `prev`, `next`, `last`) |
| `Current-Page` | Número de página actual                                 |
| `Page-Items`   | Elementos en esta página                                |
| `Total-Pages`  | Número total de páginas                                 |
| `Total-Count`  | Número total de registros                               |

## Ejemplo

```bash
curl "https://app.recurrente.com/api/products?page=2&items=10" \
  -H "X-SECRET-KEY: ..."
```

Headers de respuesta:

```
Link: <.../products?page=1&items=10>; rel="first", <.../products?page=1&items=10>; rel="prev", <.../products?page=3&items=10>; rel="next", <.../products?page=5&items=10>; rel="last"
Current-Page: 2
Page-Items: 10
Total-Pages: 5
Total-Count: 47
```

## Uso Común

Para iterar a través de todos los elementos:

1. Comienza con `page=1`
2. Procesa los resultados
3. Si `Current-Page` \< `Total-Pages`, incrementa la página y repite
4. Continúa hasta que hayas procesado todas las páginas