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.

    • propertyName
      Type: anything
      keys: 
      string
  • externalIds
    Type: object · ExternalIds
    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.

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

  • finishes
    Type: array string[] enum
    required

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

    values
    • Standard
    • Foil
    • Rainbow
    • Gold
    • Rainbow Foil
  • 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.

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

    • propertyName
      Type: object · FinishPriceBlocks
      keys: 
      string

      Up to three price blocks, keyed by source.

      property names
      • Standard
      • Foil
      • Rainbow
      • Gold
      • Rainbow Foil
      • 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.

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

  • imageBackUrl
    Type: string Format: uri

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

  • imageUrl
    Type: string Format: 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: string nullable

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