Docs / Objects

Card and SKU

The card object that the price endpoints return, and the SKUs inside it.

Card

Field	Type	Description
`card_id`	string	Our permanent ID for this card. Use it in /v1/cards/{card_id} and the lookups.
`name`	string	The card's name.
`set`	string	The set the card is from.
`number`	string or null	The card's number in its set, such as "058/102". Null for cards without one.
`rarity`	string or null	The card's rarity, such as "Common" or "Rare Holo".
`game`	string	The game, such as "Pokemon", "Pokemon Japan" or "Magic: The Gathering". GET /v1/sets lists every game.
`image_url`	string	A link to a picture of the card.
`median_listing_price`	number or null	The median price of the card's current listings, across all its SKUs. Often null. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`updated_at`	string	When we last refreshed this card's data (ISO 8601, UTC).
`skus`	array of SKU objects	Prices for each printing, condition and language. Only SKUs with current prices are listed.

SKU

One printing, condition and language of a card. Every price belongs to a SKU.

Field	Type	Description
`sku_id`	string	Our permanent ID for this SKU: one printing, condition and language of the card.
`printing`	string	The printing, such as "Normal", "Holofoil" or "Foil".
`condition`	string	"Near Mint", "Lightly Played", "Moderately Played", "Heavily Played" or "Damaged".
`language`	string	The card's language, such as "English" or "Japanese".
`market_price`	number or null	The estimated current value of this SKU, based on its recent sales. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`market_price_calculated_at`	string or null	When market_price was last calculated (ISO 8601, UTC). It changes only when the market price is recalculated, so a rarely sold card can show an older time. This is not when we fetched it; see the card's updated_at.
`sold_price_low`	number or null	The lowest price among the recent sales reported with the market price. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`sold_price_high`	number or null	The highest price among the recent sales reported with the market price. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`sold_price_count`	integer or null	How many recent sales sold_price_low and sold_price_high cover.
`listing_price_low`	number or null	The price of the cheapest copy for sale right now, without shipping. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`listing_price_low_shipping`	number or null	The shipping cost on that cheapest listing.
`listing_price_high`	number or null	The price of the most expensive copy for sale right now, without shipping. Passed on exactly as reported: never rounded, averaged or estimated by us. Null when there is none.
`listing_price_high_shipping`	number or null	The shipping cost on that most expensive listing.
`listings`	integer or null	How many listings this SKU has for sale right now.
`copies_listed`	integer or null	How many copies are for sale right now, across all listings.
`sellers`	integer or null	How many sellers have this SKU for sale right now.

The answer

Field	Type	Description
`cards`	array of card objects	The cards found, in the order you asked for them. Duplicates are listed once.
`not_found`	array of string	The card_ids you asked for that don't exist.