# Pagination

> So liest du lange Listen der Tentary API Seite für Seite: next_cursor, cursor und limit.

Source: https://tentary.com/de/help/api/pagination/
Last updated: 2026-10-27

---

Listen der Tentary API kommen seitenweise, das Neueste zuerst. Mit dem Cursor holst du die nächste Seite.

## So funktioniert es

- Listen sind nach dem Neuesten sortiert.
- `limit` legt fest, wie viele Einträge eine Seite hat. Standard ist 25. Das Maximum steht beim jeweiligen Endpunkt.
- Die Antwort enthält `next_cursor`. Schick diesen Wert als `cursor`, um die nächste Seite zu bekommen.
- Ist `next_cursor` gleich `null`, ist das die letzte Seite.

> **Wichtig:** Der Cursor merkt sich deine Filter nicht. Schick bei jeder Seite dieselben Filter und dasselbe `limit` mit.

## Beispiel

Alle Bestellungen ab dem 1. Oktober 2026, 50 pro Seite. Die erste Seite:

```bash
curl "https://api.tentary.com/v1/orders?from=2026-10-01&limit=50" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

Die nächste Seite, mit denselben Filtern und dem `next_cursor` aus der Antwort:

```bash
curl "https://api.tentary.com/v1/orders?from=2026-10-01&limit=50&cursor=<next_cursor>" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

Wiederhole das, bis `next_cursor` gleich `null` ist.

## Ungültiger Cursor

Ist ein Cursor ungültig, antwortet die API mit dem Status 400 und dem Code `bad_cursor`. Fang dann ohne Cursor von vorn an.