Card Details

Request a Missing Card (Commercial Agreement Required)

Ask Card Hedge to add a card that is missing from the catalog.

Requires a commercial agreement with Card Hedge. Contact Card Hedge to obtain your Client ID before using this endpoint.

Submit the missing card's player, set, card number, and image; the request is queued for our data team to review and add. The token field must contain your Client ID provided by Card Hedge.

Example curl:

curl -X POST "https://api.cardhedger.com/v1/cards/card-request" \
     -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "player": "River",
       "set": "2020 Panini Illusions",
       "card_number": "44",
       "subset": "",
       "image_url": "https://i.ebayimg.com/images/g/LssAAOSwjl9h2Q16/s-l1600.jpg",
       "external_id": "RiverTest1",
       "token": "your-client-id",
       "variant": "Blue"
     }'

Returns the request status and ID on success.

post/v1/cards/card-request

Request body

playerstring required

Player or character name

setstring required

Card set name (e.g., '2020 Panini Illusions')

card_numberstring required

Card number in set

subsetstring nullable

Card subset (optional)

image_urlstring required

URL to card image

external_idstring required

Your reference ID for tracking. This ID will be included in the webhook response when the card is added.

tokenstring required

Your Client ID provided by Card Hedge. This endpoint requires a commercial agreement — contact Card Hedge to obtain your Client ID.

variantstring nullable

Card variant (e.g., 'Blue', 'Refractor')

Response

Successful Response

statusstring required

Request status ('Success' or 'NOT_RUN')

messagestring required

Status message

idstring nullable

Card request ID (only on success)

Example response

{
  "id": "1766157241863x266716738264924480",
  "message": "The request was created successfully.",
  "status": "Success"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.