SealedProduct

game
Type:
required

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

Properties: 2
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.
imageCensored
Type: boolean
required

true when cardnexus.com hides the product's art by default. The image is still returned in imageUrl.
languages
Type: array of 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).

Properties: 3
productCategory
Type: string
required

What kind of sealed product this is: one of 36 categories shared by every game (e.g. booster_box, booster, bundle, prerelease_kit, commander_deck, starter_deck). The full list is in the catalog feed guide, under Sealed product categories.
productType
const:
sealed
required
availability
Type: object

What you can buy on the CardNexus marketplace for this product under the listings filters you sent. Present only when the request carried a listings object.

Properties: 3
expansion
Type:

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

Properties: 4
expansionId
Type:
min:
-9007199254740991
max:
9007199254740991

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

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.

Properties: 8
imageUrl
Type: stringFormat: uri

URL of the product's primary image (front face for cards).
releaseDate
Type: Format: 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",
  "imageCensored": false,
  "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": {}
        }
      }
    }
  }
}

CardProduct

CardProductDetail