Pagination

List endpoints use opaque keyset cursors. Start with your filters, sort, and limit, then follow links.next or pass meta.page.next_cursor unchanged.

let url = new URL('/v1/products', baseUrl);
url.searchParams.set('q', 'bourbon');
url.searchParams.set('limit', '50');

while (url) {
  const response = await fetch(url);
  if (!response.ok) throw await response.json();
  const page = await response.json();

  consume(page.data);
  url = page.links.next ? new URL(page.links.next, baseUrl) : null;
}

Guarantees

Sort order includes a unique stable identifier as a final tie-breaker.
The cursor is bound to the original normalized query and sort.
All pages from a cursor chain read one immutable publication revision.
Cursor contents are implementation details and must not be decoded or modified.

Expired or retired cursors return 410. Restart the traversal to see the current publication.

Get started

Core concepts

Integration guides

Guarantees

​Guarantees

Guarantees