Skip to content

Pagination

Collections use keyset cursor pagination. limit defaults to 50 and must be between 1 and 200.

  1. Send the first request with filters and an optional limit.
  2. Read meta.next_cursor from the response.
  3. Send that value unchanged as cursor with exactly the same filters.
  4. Stop when next_cursor is absent.

There are no page numbers, offsets, or guaranteed total counts. Cursors are opaque and bound to merchant authority, grants, resource, sort, and normalized filters. Under concurrent updates, a row may repeat; upsert by public identity and timestamp.