Sets and card identities
A card's printed number is not its catalogue ID. Use the id returned by the API: it identifies a catalogue entry, including language and printing.
Release zones
| Zone | Meaning |
|---|---|
intl | International releases |
jp | Japanese releases |
chn | Chinese releases |
Zone is distinct from the card's language. A set may contain several language and printing identities. cardCount counts catalogue identities; totalCards is the printed set size when available.
Choosing a set
A full set id is unambiguous. A shared code resolves to the newest matching set with deterministic tie-breaks. Set-card listing accepts either; search's set parameter is a code filter.
Optional fields
Absent or null means unavailable where the schema permits it. imageUrl, year and rarity are optional but not nullable. Provider fields such as illustrator, totalCards and scanFallbackUrl can be absent or null. Download the exact OpenAPI schemas.