Pagination

Pagination is the technique of splitting large API result sets into smaller chunks delivered across multiple responses. Rather than returning thousands of records in a single call, the API returns a defined number per page along with metadata to request the next page.

Common pagination mechanisms include offset-based (using page and limit parameters), cursor-based (using an opaque token pointing to the next position), and keyset-based (using the last seen record's key to fetch the next batch).

Cursor-based pagination is preferred for large, frequently-changing datasets because it avoids the duplicate and skipped record issues that affect offset pagination when data is added or removed between pages.