Get a card

GET 
/v1/cards/:card_id

One card with full detail, including the embedded prices summary.

• name is the English card name (null for the few cards with no confirmed English name); local_name is the Chinese name as printed.
• prices is null for free-tier keys, and also null on paid tiers when the card has no recorded sales yet. On the hobby tier the six graded cells inside prices.grades are null; pro sees them all. See GET /v1/cards/{card_id}/prices for how prices are computed.
• Variant prints (is_variant: true; base_card_id points at the base print) are a hobby+ perk — fetching one with a free key returns 403 tier_required.
• variant names this print's treatment (holo, reverse, masterball, a <mascot>-stamp code, …) — it is what distinguishes prints that share a set and collector number. Open-ended, not an enum.
• image_url points at the original card scan on our public CDN (images.pikaqian.com), fetchable without an API key; it is null when no servable image exists.
• language is always "zh-CN" in v1.
• Card text (every tier): hp, local_element, local_subtypes, weaknesses, resistances, retreat_cost, attacks, abilities, local_rules, local_flavor_text, regulation_mark and illustrators carry the printed card text, in Chinese verbatim (no English translation yet — as with local_name, local_ marks Chinese text). [] means "none on the card"; null means "not applicable" or not available for that print. Text keeps the inline tokens printed on the card — 【草】【火】…【无】 for energy types, 【麻痹】【混乱】【中毒】【睡眠】【灼伤】 for special conditions, 【昏厥】【基础】【撤退】【ex】【V】【GX】【VMAX】, 「…」 around card names, […] around once-per-game reminders — so clients can render icons. In attacks[].local_cost, + is the TAG TEAM GX extra-energy marker, not an energy; damage ("30+", "20×") and weaknesses[].value ("×2") are the printed strings, × being U+00D7. These fields are detail-only: list endpoints do not carry them and none is filterable in v1.

Request

Responses

200

Successful Response

422

Validation Error