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

# Paginación

> Cómo recorrer listas largas con cursores.

Los endpoints que devuelven listas usan **paginación por cursor**. En lugar de números de
página, pides una cantidad de elementos y un cursor que apunta al final de la página anterior.

## Parámetros

| Parámetro       | Tipo   | Descripción                                                 |
| --------------- | ------ | ----------------------------------------------------------- |
| `limit`         | entero | Elementos por página. Entre `1` y `100`. Por defecto `20`.  |
| `startingAfter` | string | Cursor de la página anterior. Omítelo en la primera página. |

## Respuesta

```json theme={null}
{
  "data": [ /* ... */ ],
  "hasMore": true,
  "nextCursor": "b3JkXzAx..."
}
```

| Campo        | Descripción                                              |
| ------------ | -------------------------------------------------------- |
| `data`       | Los elementos de esta página.                            |
| `hasMore`    | `true` si quedan más elementos por recorrer.             |
| `nextCursor` | Cursor para la siguiente página, o `null` si no hay más. |

## Recorrer todas las páginas

Repite la llamada pasando `nextCursor` en `startingAfter` mientras `hasMore` sea `true`.

```bash theme={null}
# Primera página
curl "https://api-v2.riqra.com/public/v1/orders?limit=50" \
  -H "Authorization: Bearer rq_live_tu_api_key"

# Siguiente página
curl "https://api-v2.riqra.com/public/v1/orders?limit=50&startingAfter=b3JkXzAx..." \
  -H "Authorization: Bearer rq_live_tu_api_key"
```

<Note>
  El cursor es opaco y está ligado a los filtros y el orden de la consulta. No cambies los demás
  parámetros entre páginas y no construyas el cursor a mano. Un cursor inválido responde `400`.
</Note>