SealedProduct

  • game
    Type: object · EmbeddedGame
    required

    A compact game reference — enough to show the game alongside a product without a separate call to GET /v1/games/{gameId}.

    • id
      Type: string
      required

      The game's identifier (e.g. mtg).

    • name
      Type: string
      required

      The game's display name.

  • gameId
    Type: string
    required

    The game this product belongs to (e.g. mtg, pokemon).

  • id
    Type: integer
    min:  
    -9007199254740991
    max:  
    9007199254740991
    required

    The product's identifier. Stable number — pass it back to address this product elsewhere.

  • languages
    Type: array string[]
    required

    Languages this product was printed in, as ISO 639 codes (e.g. en, fr, ja).

  • name
    Type: string
    required

    The product's display name.

  • nameSlug
    Type: string
    required

    URL-friendly slug derived from the product name, unique within its game. Useful as a stable lookup key.

  • prices
    Type: object
    required

    Current market prices — cardmarket (EUR), tcgplayer (USD), and cardnexus (live marketplace listings) blocks. A sealed product has a single price (no per-finish split).

    • cardmarket
      Type: object

      Cardmarket's daily price snapshot, in EUR. Absent when Cardmarket has no price.

    • cardnexus
      Type: object

      Live CardNexus marketplace listings — the EUR-converted floor across every region, plus per-region prices (eu in EUR, na in USD). Absent when there's no live listing in stock.

    • tcgplayer
      Type: object

      TCGplayer's daily price snapshot, in USD. Absent when TCGplayer has no price.

  • productCategory
    Type: string
    required

    What kind of sealed product this is (e.g. booster_box, booster_pack, bundle, prerelease_kit, commander_deck, starter_deck).

  • productType
    const:  
    sealed
    required
  • expansion
    Type: object · EmbeddedExpansion

    Compact expansion reference. Absent for products not tied to a single set.

    • code
      Type: string
      required

      Short expansion code (e.g. BLB, SV4, LOB).

    • id
      Type: integer
      min:  
      -9007199254740991
      max:  
      9007199254740991
      required

      The expansion's identifier.

    • name
      Type: string
      required

      The expansion's display name.

    • symbolUrl
      Type: string Format: uri

      URL of the expansion's set symbol image.

  • expansionId
    Type: integer · CatalogId
    min:  
    -9007199254740991
    max:  
    9007199254740991

    The expansion this product belongs to. Absent for products that aren't tied to a single set.

  • externalIds
    Type: object · ExternalIds

    This product's ids on Cardmarket and TCGplayer (one per finish) and in the game's card database (e.g. scryfallId for Magic: The Gathering). Absent when the product carries no external mapping at all. Use them to bridge with your existing integrations.

    • cardmarket
      Type: array object[]

      Cardmarket product IDs, one per finish. Empty / absent if no Cardmarket mapping exists for this product.

    • dreambornId
      Type: string

      The card's Dreamborn id. Disney Lorcana cards only.

    • fabId
      Type: string

      The card's FAB id. Flesh and Blood cards only.

    • konamiId
      Type: string

      The card's Konami id. Yu-Gi-Oh! cards only.

    • riotId
      Type: string

      The card's Riot id. Riftbound cards only.

    • scryfallId
      Type: string

      This printing's Scryfall id. Magic: The Gathering cards only.

    • scryfallOracleId
      Type: string

      The card's Scryfall oracle id, shared by every printing of the card. Magic: The Gathering cards only.

    • tcgplayer
      Type: array object[]

      TCGplayer product IDs, one per finish. Empty / absent if no TCGplayer mapping exists for this product.

  • imageUrl
    Type: string Format: uri

    URL of the product's primary image (front face for cards).

  • releaseDate
    Type: string · DateStringFormat: date-time

    When the sealed product was released (ISO 8601, UTC).

Examples
{
  "id": 50213,
  "gameId": "pokemon",
  "expansionId": 87,
  "game": {
    "id": "pokemon",
    "name": "Pokémon Trading Card Game"
  },
  "expansion": {
    "id": 87,
    "name": "Stellar Crown",
    "code": "SV4",
    "symbolUrl": "https://images.cardnexus.com/expansions/pokemon/sv4/symbol.svg"
  },
  "name": "Stellar Crown — Booster Box",
  "nameSlug": "stellar-crown-booster-box",
  "languages": [
    "en"
  ],
  "imageUrl": "https://images.cardnexus.com/products/pokemon/sv4/stellar-crown-booster-box.jpg",
  "productType": "sealed",
  "productCategory": "booster_box",
  "releaseDate": "2024-09-13T00:00:00.000Z",
  "prices": {
    "cardmarket": {
      "currency": "EUR",
      "low": 124.5,
      "mid": 132,
      "high": 145,
      "marketValue": 132.5,
      "change24h": 0.2,
      "change7d": 1.4,
      "change30d": -2.1
    },
    "tcgplayer": {
      "currency": "USD",
      "low": 134.99,
      "mid": 142,
      "high": 159,
      "marketValue": 143,
      "change24h": 0.1,
      "change7d": 1.6,
      "change30d": -1.8
    },
    "cardnexus": {
      "low": {
        "amount": 119.9,
        "currency": "EUR"
      },
      "listingCount": 3,
      "availableQuantity": 5,
      "regions": {
        "eu": {
          "currency": "EUR",
          "low": 119.9,
          "listingCount": 3,
          "availableQuantity": 5,
          "byCondition": {}
        }
      }
    }
  }
}