Overview
List endpoints return multiple items. Pagination lets you fetch them in chunks.
Prefer stable ordering
If an endpoint supports sorting, paginate using a stable ordering (e.g. by time + id) so new records don't reshuffle pages.
Common patterns
SendLib endpoints may use one of these patterns (depending on the resource):
- Cursor pagination:
?cursor=...&limit=... - Offset pagination:
?page=...&page_size=...
The endpoint's reference page should document which one it uses.
Client checklist
- Always pass a
limit/page_sizeyou can handle. - Keep requesting pages until the server indicates there's no next page.
- If you're doing a long backfill, persist your cursor/checkpoint.
Next
- Query shaping: Filtering & Sorting
- Observability patterns: Observability