MTG Copilot Docs
Data model

Sealed products

Sealed product catalogue: boxes, bundles and decks, priced only where a user owns one.

12 columns. Every value below is generated from the provenance registry.

FieldTypeSourceUpdatedWritten by
idstringcalculatedneverdatabase
Internal UUID primary key.
mtgjson_uuidstringmtgjsonon set releasescripts/seed-sealed-products.ts
MTGJSON SealedProduct uuid — the product's stable identity.
namestringmtgjsonon set releasescripts/seed-sealed-products.ts
Product display name (booster box, bundle, precon product, …).
set_codestringmtgjsonon set releasescripts/seed-sealed-products.ts
Owning set code.
set_namestringmtgjsonon set releasescripts/seed-sealed-products.ts
Owning set display name.
categorystringmtgjsonon set releasescripts/seed-sealed-products.ts
Normalized product category (booster_box, bundle, deck, …), derived from MTGJSON category/subtype.
subtypestring | nullmtgjsonon set releasescripts/seed-sealed-products.ts
MTGJSON product subtype; NULL when absent.
image_urlstring | nullmtgjsonon set releasescripts/seed-sealed-products.ts
Product image URL; currently unpopulated (null) — no sealed image source wired yet.
price_usdnumber | nullunmaintainednot refreshednone
Last known sealed retail USD price. No job refreshes it; read prices_updated_at before using it.
prices_updated_atstring | nullunmaintainednot refreshednone
When price_usd was last written. Nothing has written it since the sealed price vendor was decommissioned.
released_atstring | nullmtgjsonon set releasescripts/seed-sealed-products.ts
Product release date; falls back to the set release date.
tcgplayer_product_idstring | nullmtgjsonon set releasescripts/seed-sealed-products.ts
TCGplayer product id, used as the buy-link target.

TypeScript model

interface sealed_products {
  id:                   string
  mtgjson_uuid:         string
  name:                 string
  set_code:             string
  set_name:             string
  category:             string
  subtype:              string | null
  image_url:            string | null
  price_usd:            number | null
  prices_updated_at:    string | null
  released_at:          string | null
  tcgplayer_product_id: string | null
}

On this page