---
title: "List Price Watchlist"
method: GET
path: "/v1/cards/watchlist"
tags: ["Watchlist"]
---

# List Price Watchlist

`GET /v1/cards/watchlist`

List your watchlist entries, oldest first, paginated.

A `grade_label` of `null` means the entry watches **all grades** for that
card.

```bash
curl -H "X-API-Key: your-api-key"          "https://api.cardhedger.com/v1/cards/watchlist?page=1&page_size=100"
```

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Watchlist entries, oldest first

- WatchlistListResponse
  - `items` WatchlistEntry[], required
    - `card_id` string, required
    - `grade_label` string, nullable
    - `created_at` string, nullable
  - `total` integer, required
  - `page` integer, required
  - `page_size` 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/f2d0e595be79/schema)