CardProduct

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

Examples

{
  "id": 50212,
  "gameId": "mtg",
  "expansionId": 42,
  "game": {
    "id": "mtg",
    "name": "Magic: The Gathering"
  },
  "expansion": {
    "id": 42,
    "name": "Limited Edition Alpha",
    "code": "LEA",
    "symbolUrl": "https://images.cardnexus.com/expansions/mtg/lea/symbol.svg"
  },
  "name": "Black Lotus",
  "nameSlug": "black-lotus",
  "languages": [
    "en"
  ],
  "imageUrl": "https://images.cardnexus.com/products/mtg/lea/black-lotus-front.jpg",
  "externalIds": {
    "cardmarket": [
      {
        "finish": "Standard",
        "id": 5824
      }
    ],
    "tcgplayer": [
      {
        "finish": "Standard",
        "id": 1527
      }
    ],
    "scryfallId": "ff1b8fc5-604a-4449-a73d-861e53642a70",
    "scryfallOracleId": "b7ad39b3-5d10-45a4-99ae-30972ea6ac42"
  },
  "productType": "card",
  "printNumber": "232",
  "rarity": "rare",
  "finishes": [
    "Standard"
  ],
  "pricesByFinish": {
    "Standard": {
      "cardmarket": {
        "currency": "EUR",
        "low": 14999,
        "mid": 17500,
        "high": 32500,
        "marketValue": 18250,
        "change24h": 0.4,
        "change7d": -1.2,
        "change30d": 5.7
      },
      "tcgplayer": {
        "currency": "USD",
        "low": 16450,
        "mid": 19250,
        "high": 35200,
        "marketValue": 20100,
        "change24h": 0.3,
        "change7d": -0.9,
        "change30d": 6.1
      },
      "cardnexus": {
        "low": {
          "amount": 14500,
          "currency": "EUR"
        },
        "listingCount": 2,
        "availableQuantity": 2,
        "regions": {
          "eu": {
            "currency": "EUR",
            "low": 14500,
            "listingCount": 2,
            "availableQuantity": 2,
            "byCondition": {
              "LP": {
                "low": 14500,
                "listingCount": 2,
                "availableQuantity": 2,
                "byLanguage": {
                  "en": {
                    "low": 14500,
                    "listingCount": 2,
                    "availableQuantity": 2
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "attributes": {
    "manaCost": "{0}",
    "colors": [],
    "typeLine": "Artifact"
  }
}