{"uid":"cap_azGe1IrupArbwCZwh-tvY","slug":"api-tcgapi-dev-a19e9c00","name":"TCG API - Single Card Details by ID","description":"Single card details (name, set, image, rarity, TCGPlayer ID) for Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, and 85+ other trading card games.","url":"https://api.tcgapi.dev/v1/cards/33831","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"cardId":33831},"response":{"data":{"hp":"120","id":33831,"name":"Charizard","artist":null,"number":"004/102","rarity":"Holo Rare","set_id":5500007,"attacks":"{\"attack1\":\"[RRRR] Fire Spin (100)\\r\\n<br>Discard 2 Energy cards attached to Charizard in order to use this attack.\",\"attack2\":null,\"attack3\":null,\"attack4\":null}","game_id":55,"set_name":"Base Set (Shadowless)","set_slug":"base-set-shadowless","abilities":null,"foil_only":1,"game_name":"Pokemon","game_slug":"pokemon","image_url":"https://product-images.tcgplayer.com/fit-in/400x400/106999.jpg","clean_name":"charizard","enriched_at":"2026-06-06 18:16:24","median_price":2432.29,"product_type":"Cards","tcg_group_id":null,"tcgplayer_id":106999,"tcgplayer_url":"https://www.tcgplayer.com/product/106999","total_listings":25,"custom_attributes":{"hp":"120","stage":"Stage 2","number":"004/102","attack1":"[RRRR] Fire Spin (100)\r\n<br>Discard 2 Energy cards attached to Charizard in order to use this attack.","attack2":null,"attack3":null,"attack4":null,"cardType":["Pokemon"],"weakness":"W","cardTypeB":"Fire","energyType":["Fire"],"flavorText":"<em>Flame Pokémon. Length: 5'7\", Weight: 200 lbs.\r\n<br>Spits fire that is hot enough to melt boulders. Known to unintentionally cause forest fires.  LV. 76  #6</em>","resistance":"F-30","description":"<strong>Pokémon Power: Energy Burn</strong> As often as you like during your turn <em>(before your attack)</em>, you may turn all Energy attached to Charizard into Fire Energy for the rest of the turn. This power can't be used if Charizard is Asleep, Confused, or Paralyzed.","releaseDate":"1999-01-09T00:00:00Z","retreatCost":"3","rarityDbName":"Holo Rare"},"detail_fetched_at":null,"product_status_id":1,"shipping_category_id":1,"lowest_price_with_shipping":875}}},"exampleRequest":{"cardId":33831},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cfnzIR_nJ2pdYCqm8OLhg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed metadata for a single trading card (name, set, image URL, rarity, TCGPlayer ID) identified by its numeric card ID, covering 89+ trading card games.","exampleAgentPrompt":"Can you look up the details for trading card ID 5846 — I need the card name, set, rarity, and image URL from the TCG API?","exampleUseCases":null,"resultDescription":"A JSON object containing the card's full metadata: card name, set name, rarity tier, image URL, TCGPlayer product ID, and game name for the requested card ID.","failureModes":["Card ID not found — returns 404 or empty result for non-existent numeric IDs","Invalid card ID format — non-numeric or out-of-range IDs may return an error","Payment failure — x402 payment not accepted or insufficient USDC balance","Rate limiting — too many requests in a short window","Card exists but has incomplete metadata (missing image URL or rarity)"],"whenToPreferThis":"Use this endpoint when you already have a specific numeric card ID and need to resolve it to full card metadata. Prefer this over full-text search when you have an exact ID reference (e.g. from a previous search result, a user's collection database, or a TCGPlayer product ID). Ideal for enriching card records with names, images, and rarity data one card at a time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:45:06.032Z","isFirstParty":false}