Skip to main content

Get a card

GET /api/v1/catalog/cards/:cardId
Authorization: Bearer <ACCESS_TOKEN>

Use a full id returned by search or set-card listing, URL-encoded. Unknown IDs return 404.

Response​

{ data: Card }

FieldsContract
id, name, setName, setCode, numberNonempty strings
languageString, at least 2 characters
zoneintl, jp, chn
variantString; defaults to standard when absent
yearOptional integer ≥1996
rarityOptional nonempty trimmed string, at most 100 characters
imageUrlOptional URL
totalCardsPositive integer, optional or null
illustrator, cardmarketId, cardmarketPath, tcgplayerIdNonempty strings, optional or null
scanFallbackUrlURL, optional or null

No price, owned quantity or account field is returned. Marketplace IDs are reference metadata.

The MCP tool get_card takes cardId and returns the card directly in structuredContent, without { data }. Download OpenAPI.