today
More scalable retrieval for Items & Variations
You can now paginate through Items and Variations with cursor-based pagination for more reliable, scalable listing - especially for large catalogs.
What’s new
GET /v2/itemsandGET /v2/variationsnow support cursor-based pagination vianext_page_cursor.- Each response may return
next_page_cursor; pass it in the next request to fetch the next page of results.
Why it matters
- More reliable pagination for large result sets (reduces offset-related gaps/duplication).
- Easier to build long-running or resumable export/audit workflows.
Common customer use cases
- Catalog audits / backfills: Iterate through the full catalog safely, without relying on offset math.
- Resumable scripts: Store the last cursor to resume processing after interruptions.
- Large-catalog integrations: Reduce risk of missed/duplicated entities when the underlying catalog is changing.
How to use it (high level)
- Make a request and read
next_page_cursorfrom the response. - Repeat requests with
next_page_cursoruntil it’s empty/omitted.
Notes
next_page_cursorcan’t be combined withpageoroffset.- When using cursor pagination,
total_countis omitted.
Learn more about Retrieving Items
If you have any questions or feedback, please connect with your Customer Success Manager.