Docs / API reference

One card

A card's current prices for every printing, condition and language it sells in.

Request

GEThttps://tcgpriceapi.com/v1/cards/{card_id}

Name	Type	Description
`card_id`required	string	The card's `card_id`, from a search. It never changes, so you can store it.
`printing`	string	Only this printing, such as `Holofoil`.
`condition`	string	Only this condition, such as `Near Mint`.
`language`	string	Only this language, such as `English`.

Counts as one request.

Request

curl "https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c?condition=Near%20Mint" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c?condition=Near%20Mint",
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c?condition=Near%20Mint", {
  headers: { "X-API-Key": process.env.TCGPRICEAPI_KEY },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

Response

Response 200

{
  "cards": [
    {
      "card_id": "card_1c3aaea45434413c",
      "name": "Charizard",
      "set": "Base Set",
      "number": "004/102",
      "rarity": "Holo Rare",
      "game": "Pokemon",
      "image_url": "https://tcgplayer-cdn.tcgplayer.com/product/42382_in_1000x1000.jpg",
      "median_listing_price": null,
      "updated_at": "2026-11-12T01:23:07+00:00",
      "skus": [
        {
          "sku_id": "sku_4687030dac764c67",
          "printing": "Holofoil",
          "condition": "Near Mint",
          "language": "English",
          "market_price": 987.13,
          "market_price_calculated_at": "2026-11-11T11:47:32.789Z",
          "sold_price_low": 695.95,
          "sold_price_high": 1500,
          "sold_price_count": 14,
          "listing_price_low": 785.0,
          "listing_price_low_shipping": 0.99,
          "listing_price_high": 8999.0,
          "listing_price_high_shipping": 0.0,
          "listings": 26,
          "copies_listed": 28,
          "sellers": 21
        }
      ]
    }
  ],
  "not_found": []
}

A real answer from our database, saved on 12 November 2026.

Each card has a list of SKUs. A SKU is one printing, condition and language. See Card and SKU for every field. An unknown card_id is listed under not_found rather than failing the request.