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 }
| Fields | Contract |
|---|---|
id, name, setName, setCode, number | Nonempty strings |
language | String, at least 2 characters |
zone | intl, jp, chn |
variant | String; defaults to standard when absent |
year | Optional integer ≥1996 |
rarity | Optional nonempty trimmed string, at most 100 characters |
imageUrl | Optional URL |
totalCards | Positive integer, optional or null |
illustrator, cardmarketId, cardmarketPath, tcgplayerId | Nonempty strings, optional or null |
scanFallbackUrl | URL, 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.