CAcardhedger
Card Details

Get Card Variants

Return the other variants (parallels) of a card.

A variant group is every active card sharing the source card's exact set, number, and subset. Blank, null, "null", and "none" subsets are treated as "Base Set" when comparing identity. The source card itself is excluded. Results are ordered by 30-day sales volume descending, with 7-day sales volume and primary price as tie-breakers. At most 100 cards are scanned as a safety backstop.

Cards without both a set and card number, unknown card IDs, and cards with no other active variants return an empty list.

Example curl:

curl -X POST -H "X-API-Key: your-api-key-here"          -H "Content-Type: application/json"          -d '{"card_id":"1587446850514x224832321163624450"}'          "https://api.cardhedger.com/v1/cards/card-variants"
post/v1/cards/card-variants

Request

  • Base URL
    https://api.cardhedger.com
  • Auth
    API key in header X-API-Key

Request body

card_idstring required

Unique Card Hedge card identifier

raw_images_onlyboolean nullable

Image preference. Omitted (default): return the raw card photo, falling back to the graded slab image only when no raw photo exists. true: force raw-only (no graded fallback). false: prefer the graded slab image.

Response

Successful Response

countinteger required

Number of other variants returned

Changes

No recorded changes to this operation across all 14 revisions of this API.