Pagination

Listen-Endpunkte liefern Seiten mit Cursor. Der Cursor ist stabil, auch wenn währenddessen neue Einträge hinzukommen.

Query-Parameter	Bedeutung
`limit`	Einträge pro Seite, 1 bis 100, Standard 25
`cursor`	Wert von `nextCursor` der vorherigen Antwort

Antwort

{
  "object": "list",
  "data": [ { "id": "…" }, { "id": "…" } ],
  "hasMore": true,
  "nextCursor": "eyJ2IjpbIjIwMjYtMTEtMDQiXSwiaWQiOiJ…"
}

hasMore ist true, solange weitere Seiten folgen; dann enthält nextCursor den Cursor für die nächste Seite, sonst null.
Der Cursor ist undurchsichtig – nicht selbst bauen oder auswerten. Er gilt nur zusammen mit denselben Filtern wie in der ersten Anfrage.
Ein ungültiger Cursor liefert 400 validation_error.

Alle Seiten abrufen

# erste Seite
curl 'https://www.debt-flow.io/api/v1/contacts?limit=100' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"

# nächste Seite mit nextCursor aus der vorigen Antwort
curl 'https://www.debt-flow.io/api/v1/contacts?limit=100&cursor=eyJ2Ijpb…' \
  -H "Authorization: Bearer $DEBTFLOW_API_KEY"