Skip to main content

Pagination and limits

Only the cards-of-a-set operation is paginated.

ParameterDefaultBounds
page1Integer ≥ 1
pageSize50Integer 1–200
Search limit25Integer 1–100

The REST set-card response includes meta: { page, pageSize, total }. A known empty set or a page past the end returns an empty array and metadata. An unknown set returns 404.

Search returns its first limit matches without a total or paging cursor. Use set pagination to enumerate a set.

Changing snapshots​

Reads follow the active import. The snapshot may change between pages: there is no snapshot token or stable export session. Reconcile results by returned card ID.

Request volume​

No per-partner request quota is currently documented or enforced by the catalogue guard. This is not an unlimited-traffic commitment. Agree expected volume with your access contact and keep concurrency modest. For transient failures, retry reads with bounded backoff.