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.

Properties: 1
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.
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
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).

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",
  "imageCensored": false,
  "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"
  }
}

ExpansionSummary

SealedProduct