> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/es/developers/api/pagination.md).

# Paginación

> Recorra listas largas en la API de BoxHero con paginación basada en cursor.

Los endpoints de listas devuelven los resultados página por página y usan paginación basada en cursor.

## Parámetros de consulta

| Parámetro | Descripción |
| --- | --- |
| `cursor` | Dónde comienza la página. Pase el campo `cursor` de la respuesta anterior. Omítalo en la primera llamada. |
| `limit` | Tamaño de la página. El rango permitido y el valor predeterminado se indican en cada endpoint, por ejemplo en [List items](https://www.boxhero.io/docs/es/developers/api/reference/items/list-items). |

## Respuesta

Cada página incluye los resultados junto con los campos necesarios para obtener la siguiente:

```json
{
  "items": [...],
  "count": 100,
  "limit": 100,
  "cursor": 1234567,
  "has_more": true
}
```

| Campo | Descripción |
| --- | --- |
| `count` | Número de resultados en esta página |
| `limit` | Tamaño de página usado en esta página |
| `cursor` | Páselo como parámetro de consulta `cursor` para obtener la página siguiente. `null` cuando no hay más páginas. |
| `has_more` | `true` si hay más resultados después de esta página |

## Obtener todas las páginas

1. Llame al endpoint de lista sin `cursor`.
2. Mientras `has_more` sea `true`, vuelva a llamarlo con `cursor` igual al `cursor` de la última respuesta.
3. Deténgase cuando `has_more` sea `false`.

```bash
curl "https://rest.boxhero-app.com/v1/items?cursor=1234567" \
  -H "Authorization: Bearer $BOXHERO_API_TOKEN"
```

Mantenga en todas las llamadas siguientes los mismos filtros que usó en la primera.

## Orden

Cada recurso define su propio orden. La mayoría de los endpoints de listas devuelven los resultados por id, en orden ascendente. [List transactions](https://www.boxhero.io/docs/es/developers/api/reference/transactions/list-transactions) devuelve primero las transacciones más recientes (por hora de la transacción, con el id como criterio de desempate).

> **Tip**
>
> **Consejo**: Para mantener sincronizada una copia de sus transacciones, guarde la `revision` de cada transacción. Cuando vuelva a recorrer la lista, una `revision` mayor indica que la transacción se editó desde la última vez que la vio.