Pagination
ConceptsPagination is the practice of returning a large list in smaller pages rather than all at once. DocLD list endpoints (e.g., documents, knowledge base documents, sessions) support pagination via a cursor or offset and limit. The response includes the current page of items and a way to fetch the next page (e.g., nextCursor or page).
Why It Matters
- Performance — Avoid loading thousands of records in one response.
- Stability — Smaller responses reduce timeouts and memory use.
- Consistency — Cursor-based pagination can be more stable for changing data.
When integrating with the API or SDK, follow the docs for the specific endpoint to see whether it uses cursor, offset, or page-based pagination and how to request the next page.
Related Concepts
Pagination is used on list endpoints of the API. SDK methods may abstract pagination (e.g., iterators) so you don’t manage cursors manually.