Paginación - Finzaria

Los endpoints de listado (transacciones, etc.) paginan por cursor. El cursor es opaco — no lo construyas ni lo interpretes; solo reenvíalo tal cual.

Request

Parámetro	Tipo	Descripción
`limit`	número	Cuántos resultados por página (con tope).
`cursor`	string	El `nextCursor` de la página anterior. Omítelo en la primera.

Respuesta

{
  "items": [ /* … */ ],
  "nextCursor": "eyJ0IjoiMjAyNi0wNy0wMSJ9"
}

items — los resultados de esta página.
nextCursor — pásalo como cursor para pedir la siguiente. Cuando es null, llegaste al final.

Recorrer todo

let cursor
const all = []
do {
  const url = new URL("https://api.finzaria.com/v1/transactions")
  url.searchParams.set("limit", "100")
  if (cursor) url.searchParams.set("cursor", cursor)
  const res = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.FINZARIA_API_KEY}` },
  })
  const page = await res.json()
  all.push(...page.items)
  cursor = page.nextCursor
} while (cursor)

import os, requests

items, cursor = [], None
while True:
    params = {"limit": 100}
    if cursor:
        params["cursor"] = cursor
    page = requests.get(
        "https://api.finzaria.com/v1/transactions",
        headers={"Authorization": f"Bearer {os.environ['FINZARIA_API_KEY']}"},
        params=params,
    ).json()
    items += page["items"]
    cursor = page["nextCursor"]
    if not cursor:
        break

El cursor es estable ante inserciones: aunque se creen transacciones mientras paginas, no repites ni te saltas resultados (a diferencia de paginar por offset).