> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emify.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Paginado y rate limit

> Cómo recorrer resultados paginados y qué esperar de los límites de uso de la API.

## Paginado

Los endpoints de listado devuelven los resultados en páginas. Controla la paginación con dos parámetros de query:

| Parámetro  | Descripción                        |
| ---------- | ---------------------------------- |
| `page`     | Número de página a consultar.      |
| `per_page` | Cantidad de resultados por página. |

```bash theme={null}
curl "https://api.emify.co/api/companies/{company_id}/invoices?page=1&per_page=50" \
  -H "X-Api-Key: tu_api_key"
```

La respuesta incluye los datos y los metadatos de paginación:

```json theme={null}
{
  "data": [ { "...": "..." } ],
  "current_page": 1,
  "per_page": 50,
  "total": 85,
  "last_page": 2
}
```

| Campo          | Descripción                    |
| -------------- | ------------------------------ |
| `data`         | Registros de la página actual. |
| `current_page` | Página devuelta.               |
| `per_page`     | Resultados por página.         |
| `total`        | Cantidad total de registros.   |
| `last_page`    | Última página disponible.      |

Recorre las páginas incrementando `page` hasta llegar a `last_page`.

<Tip>
  El listado de documentos admite además filtros como `invoice_type`, `status`, `invoice_date_from`, `invoice_date_to`, `number` y `recipient_document_number`. Consulta la [referencia de la API](/api-reference/introduccion) para la lista completa.
</Tip>

## Rate limit

Diseña tu integración para reintentar con backoff ante respuestas `5xx` y para no emitir ráfagas innecesarias de peticiones. Los límites de uso concretos se documentarán aquí cuando estén definidos.