Skip to main content
A card is one entry in one expansion — Charizard from Base Set, base1-4. Its id is the expansion id and the collector number joined by a hyphen, and it is stable: it is the id to store against your own rows.

​
Printings

A card exists in more than one physical printing, and variants is the list of them. Two fields on a variant look similar and are not:
​
string
The printing — normal, holo, reverse. What was done to the card at the press.
​
string | null
The physical size — standard, jumbo. How big the piece of cardboard is.
They are different axes. A jumbo card and a holo card are not two options from one list, and rendering them side by side reads as though they were. Prices hang off the variant rather than off the card, because they differ per printing: a holo Charizard and a normal Charizard are not the same object to a buyer. For some cards the printing list is derived from the priced printings rather than taken from the upstream variant data, because upstream ships a default that claims every card is normal — including cards it prices as holo in the same payload. Where that happens, the printings here can differ from what other catalogs show. Ours follow the money.

​
Prices

Every variant carries up to two price blocks, from two marketplaces in two currencies:
​
array
USD, one entry per condition, each with market, low and high.
​
object | null
EUR, with avg, low and trend, plus _holo counterparts. price_kind names which of the two column sets belongs to this printing — null where it could not be determined.
Each carries its own observed_on. The two sources are gathered independently, so their dates do not have to agree, and neither is a conversion of the other. For the full daily history rather than the latest figure, see Get card prices.

​
Images

image is { low, high }, or null where we hold no art. Both rungs are always complete and ready to use, and the two may be the same URL where only one rendition exists — so a client never has to branch on it.

​
Example

The captured payload already carries exactly one ability and one attack, so there is nothing further to trim without deleting the only entry in either array — pasted in full below.