Pagination
List endpoints that can return large result sets use cursor-based pagination.
How it works
- Make the initial request.
- If more results exist, the response's
metaobject includes anext_cursortoken. - Request the next page by passing that token back as the
cursorquery parameter. - Repeat until
next_cursoris empty (or absent), which means you've reached the end.
# First page
curl "https://api.abcsalesbot.com/v1/<resource>" \
-H "Authorization: Bearer $ABC_API_KEY"
# Next page: pass the previous response's meta.next_cursor
curl "https://api.abcsalesbot.com/v1/<resource>?cursor=eyJpZCI6MTIzfQ" \
-H "Authorization: Bearer $ABC_API_KEY"
Treat the cursor as an opaque token: don't parse, construct, or persist it across schema changes. Check each endpoint in the API Reference for whether it paginates and any additional filters it accepts.