The Sealed product object

One sealed product: a booster box, a pack, an Elite Trainer Box, a bundle and so on, with its TCGplayer and Cardmarket prices.

Returned by GET /v1/sealed and GET /v1/sealed/{id}.

Fields

Every field is always present. A field is null only where its type says | null, and a list with nothing in it is [], never null.

Field	Type	Description
id	string	`sealed_tcg_` and TCGplayer's product id for a product TCGplayer sells, which is stable; `sealed_cm_` and Cardmarket's for one only Cardmarket sells, replaced by the TCGplayer id if TCGplayer starts selling it.
game	string	The game's slug. One of: `pokemon`, `magic-the-gathering`, `one-piece`, `yugioh`, `disney-lorcana`, `star-wars-unlimited`, `digimon`, `grand-archive`, `dragon-ball-super`
name	string	The product's name, as the marketplace it is read from spells it.
type	string	What kind of product it is, read from its name. `booster-box` covers booster displays and half, mini and draft boxes; `case` is a sealed case of other products, or a display of decks, tins or blisters; `collection` covers premium, special and gift boxes, Build & Battle boxes and deck builder's toolkits; `blister` includes checklane packs; `other` is a real sealed product that is none of these, such as a Secret Lair drop, a prerelease kit or an advent calendar. One of: `booster-box`, `pack`, `etb`, `bundle`, `collection`, `tin`, `blister`, `deck`, `case`, `other`
language	string	The language of the product's cards: `en`, or `ja` for Japanese Pokémon and One Piece, and so on.
set	CardSet \| null	The set it belongs to, by the same codes `/v1/sets` uses. Null for products filed under no set: most tins, collections and promotional bundles.
set.code	string	The set code. Unique within a game and language, not across them.
set.name	string	The set name.
set.language	string	The set's own language: `en` for an English set whatever language the printing is in, `ja` for a set printed only in Japan.
set.releasedAt	string \| null	Release date, `YYYY-MM-DD`.
releasedAt	string \| null	`YYYY-MM-DD`: the date TCGplayer lists for the product, or failing that its set's. A future date on a preorder. Null where neither is known.
presale	boolean	Listed on TCGplayer for preorder and not yet released.
upc	string \| null	The barcode, UPC-A or EAN, digits only, where TCGplayer shows one: some Magic, Pokémon and Yu-Gi-Oh! products. Null for most products and for every other game. Retail assortments can share one code across their variants.
images	Images \| null	The product photograph from our CDN. Null until it has been mirrored, and for products only Cardmarket sells.
images.small	string \| null	244 px wide.
images.normal	string \| null	488 px wide.
images.large	string \| null	745 px wide.
prices	SealedPrice[] (SealedPrice reference)	The current quotes, one per marketplace at most. `priceStatus` says why one is missing.
priceStatus	SealedPriceStatus (SealedPriceStatus reference)	Why each marketplace's quote is or is not on `prices`.
externalIds	ExternalIds	The marketplace products it is read from.
externalIds.cardmarketId	integer \| null	Cardmarket's product id (`idProduct`).
externalIds.tcgplayerId	integer \| null	TCGplayer's product id.

Sealed price

One marketplace quote on a sealed product. The same fields as a card's Price.

Field	Type	Description
source	string	The marketplace the quote was read from: TCGplayer or Cardmarket. One of: `tcgplayer`, `cardmarket`
region	string	`EU` for Cardmarket, `NA` for the three US sources. One of: `EU`, `NA`
listType	string	Always `retail`: what a buyer pays. One of: `retail`
finish	string	Always `sealed`, so a parser written for a card's quotes reads these unchanged. One of: `sealed`
currency	string	`EUR` on Cardmarket, `USD` everywhere else. Amounts are never converted. One of: `EUR`, `USD`
market	number \| null	The headline price, in major units. TCGplayer's market price, null on a product with too few sales for one; Cardmarket's trend, or its average sale price where it has no trend. A Cardmarket figure on its 2-cent floor while a listing of a euro or more stands above it is how a product with no recent sales reports, so that product is `unquoted` rather than priced at the floor.
low	number \| null	The lowest listing price the source reports. Cardmarket's spans every language it lists the product in, as on cards.
trend	number \| null	Cardmarket's trend price. Null on the other sources.
avg1	number \| null	Cardmarket's average sale price over 1 day. Null elsewhere.
avg7	number \| null	Cardmarket's average sale price over 7 days. Null elsewhere.
avg30	number \| null	Cardmarket's average sale price over 30 days. Null elsewhere.
basis	string \| null	Cardmarket: always `price-guide`, its daily price guide file. Null on TCGplayer. One of: `price-guide`
updatedAt	string	When we last read this quote from the source. ISO 8601 timestamp, UTC.

Sealed price status

Why a sealed product's quote is or is not present, in the same words as a card's.

Field	Type	Description
tcgplayer	string	`priced`; `unquoted`, identified with no usable price today; or `unlisted`, a product TCGplayer does not sell. One of: `priced`, `unquoted`, `unlisted`, `game_unlisted`
cardmarket	string	`priced`; `unquoted`; `unlisted`, no Cardmarket product tied to this one; or `game_unlisted` for Grand Archive, which Cardmarket does not carry. One of: `priced`, `unquoted`, `unlisted`, `game_unlisted`