title: “Paginate a long API response” description: “Use the next_page cursor to iterate over large lists without missing records.” audience: [“developer”] modules: [“api”] estimated_minutes: 3 last_reviewed: “2026-05-03”

Paginate a long API response

The API uses cursor-based pagination: the last record of one page defines the start of the next. This avoids inconsistencies when new data is inserted during iteration.

TL;DR

Read meta.next_page and pass it as ?cursor=... in the next call.

Steps

1. Call GET /v1/members?limit=100. 2. In the response, read meta.next_page (opaque string). 3. If present, call GET /v1/members?limit=100&cursor=$next_page. 4. Repeat until meta.next_page is null. 5. Do not parse the cursor contents: it is opaque and may change.