page and page_size
query parameters. The response includes enough metadata to know whether more
pages exist.
Request
Query parameters
Response shape
items— the array of results for the current pagetotal— total count across all pagespage— the page you requested (echoed back)page_size— the page size you requested (echoed back)has_more—trueif another page exists
Iterating through all pages
Python (using the SDK)
Python (manual)
cURL (bash)
Best practices
- Prefer
page_size=100(the maximum) to reduce the number of round-trips - Don’t re-fetch old pages if you’re only looking for new items — keep a
local cursor of the highest
created_atyou’ve seen and filter client-side - Use the SDK’s iterator when you need to process everything — it handles pagination correctly even if items shift between pages due to concurrent writes