Guides ยท Engineering
API Pagination Troubleshooting Basics
Fix common API pagination issues
This guide explains how to troubleshoot API pagination: verify parameters, sort order, cursor validity, duplication causes, and handling of new/removed records between calls.
- pagination
- cursors
- offset
- api troubleshooting
- sorting
Confirm parameters
Check limit/offset or cursor fields and that you?re passing them correctly.
Lock sorting
Use stable ordering on a unique key to avoid missing/duplicate rows.
Handle churn
Between pages records can change; use cursors or timestamps to reduce drift.
Validate cursors
Ensure cursors aren?t expired or tied to different filters; handle end-of-list cleanly.