Watchlist

Remove Cards from Price Watchlist

Remove watchlist entries (batch), or clear the whole list.

Request fields:

  • items — list. Entries to remove (max 100). The grade must match the stored entry exactly: an all-grades entry is removed by omitting grade_label; a "PSA 10" entry is removed by passing "PSA 10".
  • clear_all — boolean. Remove every entry.

Exactly one of items or clear_all is required; passing both is rejected with HTTP 400. Removing an entry stops its updates immediately. removed is the count of entries actually deleted (already-absent items simply count zero).

curl -X DELETE -H "X-API-Key: your-api-key"          -H "Content-Type: application/json"          -d '{"items": [{"card_id": "1586812246197x228181943611293700", "grade_label": "PSA 10"}]}'          "https://api.cardhedger.com/v1/cards/watchlist"
delete/v1/cards/watchlist

Request body

clear_allboolean

Response

Number of entries removed

removedinteger required

Changes

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