---
title: "Card object — JustTCG API"
description: "Field reference for the JustTCG Card object: stable uuid, legacy id slug, name, game, set, number, rarity, TCGplayer/Scryfall IDs, and the variants array."
url: https://justtcg.com/docs/schema/card
markdown_url: https://justtcg.com/docs/schema/card.md
---

# Card object

The Card object holds metadata for a trading card. Pricing lives on its variants array.

Current production schema. Returned by every v1 endpoint.

## Properties

| Property | Type | Description |
| --- | --- | --- |
| uuid | string | Stable, canonical identifier for the card (UUID v5). **Recommended** as your primary key — see [Identifiers](https://justtcg.com/docs/identifiers). |
| id | string | Legacy human-readable slug. Frequently referred to as `cardId`. Still queryable, but no longer the recommended key. |
| name | string | Name of the card. |
| game | string | Name of the game the card belongs to (e.g. 'Pokemon'). |
| set | string | Unique ID of the set the card belongs to. |
| set\_name | string | Name of the set the card belongs to. |
| number | string | Card number within the set. |
| tcgplayerId | string | TCGplayer product ID. |
| mtgjsonId | string | MTGJSON UUID for this card. |
| scryfallId | string | Scryfall UUID for this card. |
| rarity | string | Rarity of the card (e.g. 'Common', 'Rare', 'Promo'). |
| details | string \| null | Additional card-specific details (when applicable). |
| variants | Variant\[\] | Array of [Variant](https://justtcg.com/docs/schema/variant) objects with pricing. |

Cards do not directly contain pricing. Pricing is stored on each [Variant](https://justtcg.com/docs/schema/variant) within the `variants` array.

## Card IDs

Every card carries a stable `uuid` and a legacy human-readable `id` (the `cardId`, structured as `game-set-name-rarity`). Both can be used for direct lookups via the `/cards` endpoint, but we recommend preferring `uuid`. See [Identifiers](https://justtcg.com/docs/identifiers) for the full breakdown and how slugs are composed.

Note: multiple variants of the same card may exist, each with its own variant ID.

## Example

```json
{
  "uuid": "f8c3de3d-1fea-5d7c-a8b0-29f63c4c3454",
  "id": "pokemon-battle-academy-fire-energy-22-charizard-stamped-promo",
  "name": "Fire Energy (#22 Charizard Stamped)",
  "game": "Pokemon",
  "set": "battle-academy-pokemon",
  "set_name": "Battle Academy",
  "number": "N/A",
  "tcgplayerId": "219042",
  "rarity": "Promo",
  "details": null,
  "variants": [
    {
      "uuid": "a1b2c3d4-5e6f-5a7b-8c9d-0e1f2a3b4c5d",
      "id": "pokemon-battle-academy-fire-energy-22-charizard-stamped-promo_near-mint",
      "printing": "Normal",
      "condition": "Near Mint",
      "price": 4.99,
      "lastUpdated": 1743100261,
      "priceStatus": "current",
      "lastKnownPrice": null
    }
  ]
}
```