CardProductDetail

  • attributes
    Type: object
    required

    Game-specific attributes (e.g. MTG mana cost and colors, Pokémon HP and types). Schema varies by game; the values reflect what's stored on the catalogue entry.

    Properties: 1
  • externalIds
    Type:
    required

    IDs this product carries on other marketplaces and card databases. Use these to bridge with existing Cardmarket / TCGplayer integrations or external card data sources.

    Properties: 8
  • finishes
    Type: array of stringenum
    required

    The finishes this card was printed in (e.g. Standard, Foil, Reverse Holo).

    values
    • Standard

      A standard, non-foil card.

    • Foil

      A foil card.

    • Rainbow
    • Gold
    • Rainbow Foil
    • Cold Foil
    • Gold Foil
    • Etched

      A card with an etched-foil finish.

  • 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.

  • pricesByFinish
    Type: object
    required

    Current market prices keyed by finish — up to three blocks per finish: cardmarket (EUR), tcgplayer (USD), and cardnexus (listings live on the CardNexus marketplace). Only finishes with pricing data are present — missing keys mean there's no price for that finish yet. An empty object means the card has no pricing data at all.

    Properties: 1
  • productType
    const:  
    card
    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.

  • imageBackUrl
    Type: stringFormat: uri

    URL of the card's back image. Present for double-faced cards (MTG) and similar.

  • imageUrl
    Type: stringFormat: uri

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

  • printNumber
    Type: string

    The card's print number within its expansion (e.g. 001/271, 38/91). String, not numeric — formats vary by game.

  • rarity
    Type: stringnullable

    The card's rarity. Values are game-specific (e.g. common, uncommon, rare, mythic for MTG; common, uncommon, rare, holo-rare, secret-rare for Pokémon).

  • variant
    Type: string

    Variant identifier when a card has multiple printings within the same expansion (e.g. borderless, extended-art, showcase, promo).

Previous
SealedProduct
Next
SealedProductDetail