Skip to main content

Pagination

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

  1. Use SDK iterators — Both SDKs handle pagination automatically via for loops
  2. Set appropriate limits — Use limit=100 for bulk processing, smaller values for UI
  3. Don’t store cursors long-term — Cursors may expire after 24 hours
  4. 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.