Paginación

Todos los listados paginan por cursor. No hay page ni offset.

curl -s "$BASE/v1/payments?limit=25" -H "x-api-key: $KEY"

{
  "data": [ "…" ],
  "has_more": true,
  "next_cursor": "MjAyNi0wOC0zMFQxOTowNDowMS44MTJafDg5OTIwNDAx"
}

Pasa next_cursor como ?cursor= para la página siguiente, y para cuando has_more sea false.

Parámetros

Parámetro	Por defecto	Máximo	Notas
`limit`	`25`	`100`	Un valor inválido o fuera de rango se ajusta en silencio, no da error
`cursor`	—	—	Opaco. No lo construyas ni lo interpretes

Campos de la respuesta

Campo	Qué es
`data`	Las filas de esta página
`has_more`	`true` si queda al menos una página más
`next_cursor`	El cursor de la siguiente página. `null` cuando `has_more` es `false`

Endpoints paginados

Endpoint	Orden	Cursor
`GET /v1/payments`	`created_at` descendente	Keyset sobre `(created_at, id)`
`GET /v1/beneficiaries`	`created_at` descendente	Keyset sobre `(created_at, id)`
`GET /v1/events`	`id` descendente	El id numérico del evento

GET /v1/payouts/banks no pagina: devuelve el catálogo completo del instrumento.

El cursor apunta a la última fila que te llevaste, no a una posición: puedes seguir dispersando mientras paginas sin filas duplicadas ni saltadas.

Recorrer una lista entera

CURSOR=""
while :; do
  RESP=$(curl -s "$BASE/v1/payments?status=settled&limit=100&cursor=$CURSOR" -H "x-api-key: $KEY")
  echo "$RESP" | jq -c '.data[]'
  [ "$(echo "$RESP" | jq -r .has_more)" = "true" ] || break
  CURSOR=$(echo "$RESP" | jq -r .next_cursor)
done

Filtra en el servidor (status, from, to, beneficiaryId) antes de paginar: menos páginas contra tu límite.