JustTCG
Documentation

/cards

Most-used endpoint

One endpoint, two methods. Use GET to look up a single card; POST to fetch up to 200 in one request.

GEThttps://api.justtcg.com/v1/cards
cardId
string
Optional
Direct lookup by card ID.
variantId
string
Optional
Direct lookup by variant ID — fastest path.
tcgplayerId
string
Optional
TCGplayer product ID.
mtgjsonId
string
Optional
MTGJSON UUID.
scryfallId
string
Optional
Scryfall UUID.
tcgplayerSkuId
string
Optional
TCGplayer SKU ID (variant-level).

Response

typescript — request.ts
request.ts
import { JustTCG } from 'justtcg-js';

const client = new JustTCG();
const { data } = await client.cards.get({
  cardId: 'pokemon-battle-academy-fire-energy-22-charizard-stamped',
  condition: ['NM', 'LP'],
  priceHistoryDuration: '30d',
});

console.log(data[0].variants[0].price);
json — response · 200 OK
response · 200 OK
{
  "data": [
    {
      "id": "pokemon-battle-academy-fire-energy-22-charizard-stamped",
      "name": "Fire Energy (#22 Charizard Stamped)",
      "game": "Pokemon",
      "set": "battle-academy-pokemon",
      "set_name": "Battle Academy",
      "rarity": "Promo",
      "variants": [
        {
          "id": "pokemon-…_near-mint",
          "condition": "Near Mint",
          "printing": "Normal",
          "price": 4.99,
          "lastUpdated": 1743100261
        }
      ]
    }
  ],
  "meta": { "total": 1, "limit": 20, "offset": 0, "hasMore": false },
  "_metadata": {
    "apiPlan": "Pro",
    "apiRequestsRemaining": 49213
  }
}