Skip to main content
Some API lists return one page at a time. A cursor is a value that tells the API where to start the next page. Copy it from the response without changing it. Keep the same filters and sort order. Each operation lists the maximum number of items per page.

Match the response format

Access lists

Access lists that use a cursor return items and page:
Continue while page.hasMore is true, passing page.nextCursor as cursor. Process each Access page. When page.hasMore is true, send page.nextCursor as the next request cursor. Stop when hasMore is false. The SDKs can fetch each page for you. This example prints the user ID from every chat:
TypeScript SDK

Linked accounts

In the TypeScript SDK, use client.linkedAccounts.iterate() to read all pages. GET /v3/linked-accounts returns data, has_more, and next_cursor. Pass next_cursor as cursor while has_more is true. The token response includes only the first page of linked accounts. Use its cursor to get the rest. See List linked accounts for a complete example.

Other lists

Lists do not all use the same page format. Vault+, analytics, and some other operations return different fields. Check the endpoint’s input and response fields before requesting the next page.