Skip to main content

List cards in a set

GET /api/v1/catalog/sets/:code/cards?page=1&pageSize=50
Authorization: Bearer <ACCESS_TOKEN>

Use a returned set code or full set ID in :code, URL-encoded. page starts at 1; pageSize defaults to 50 and is limited to 200.

Response​

{ data: Card[], meta: { page, pageSize, total } }

Cards follow stored normalized printed-number order, then card ID. A page beyond the end returns an empty array with metadata. An unknown set returns 404.

The corresponding MCP tool is list_cards, with setCode, page and pageSize. Its result is { page, pageSize, total, cards }, without the REST envelope.

Card fields · Pagination behavior