List endpoints return paginated results using cursor-based pagination. This approach is stable under concurrent writes and scales to millions of records.
Response Envelope
All list endpoints return a standard envelope:
Using Cursors
Pass the cursor from the previous response to fetch the next page:
Parameters
Collect All Results
Paginated Endpoints
Best Practices
- Use SDK iterators — Both SDKs handle pagination automatically via
for loops
- Set appropriate limits — Use
limit=100 for bulk processing, smaller values for UI
- Don’t store cursors long-term — Cursors may expire after 24 hours
- Use filters to reduce pages — Apply server-side filtering instead of client-side
Cursors are opaque — do not parse, modify, or construct them manually. They may change format without notice.