---
title: "Remove Cards from Price Watchlist"
method: DELETE
path: "/v1/cards/watchlist"
tags: ["Watchlist"]
---

# Remove Cards from Price Watchlist

`DELETE /v1/cards/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).

```bash
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"
```

## Request body

- WatchlistDeleteRequest
  - `items` WatchlistItemIn[], nullable
    - `card_id` string, required — CardHedge card ID, or '*' to watch the entire catalog (enterprise tier only; '*' cannot carry a grade_label).
    - `grade_label` string, nullable — Grade exactly as used across the API (e.g. 'PSA 10', 'Raw'). Omit to watch all grades for the card.
  - `clear_all` boolean

## Response `200`

Number of entries removed

- WatchlistDeleteResponse
  - `removed` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/cardhedger/apis/card-hedge-api.md) · [All operations](https://skmtc.dev/cardhedger/apis/card-hedge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardhedger/card-hedge-api/revisions/497390569396/schema)