---
title: "List Watchlists"
method: GET
path: "/api/watchlists"
tags: ["watchlists"]
---

# List Watchlists

`GET /api/watchlists`

## Request

- Base URL: `https://api.halalterminal.com`
- URL: `https://api.halalterminal.com/api/watchlists`
- Auth: API key in header `X-API-Key`

List all watchlists.

Returns every watchlist owned by the authenticated user, ordered by
creation date.

**curl example**:
```bash
curl https://api.halalterminal.com/api/watchlists \
  -H "X-API-Key: sk_live_abc123def456"
```

**Python example**:
```python
import requests

resp = requests.get(
    "https://api.halalterminal.com/api/watchlists",
    headers={"X-API-Key": "sk_live_abc123def456"},
)
watchlists = resp.json()
```

## Response `200`

All watchlists for the authenticated user

- WatchlistResponse[]
  - `id` string, required: Unique watchlist identifier
  - `name` string, required: Display name of the watchlist
  - `symbols` string[], required: Ticker symbols in the watchlist
  - `count` integer, required: Number of symbols currently in the watchlist
  - `created_at` string, required: ISO-8601 timestamp when the watchlist was created
  - `updated_at` string, required: ISO-8601 timestamp of the last modification

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/halalterminal/apis/halal-terminal-api.md) · [All operations](https://skmtc.dev/halalterminal/apis/halal-terminal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/halalterminal/apis/halal-terminal-api/revisions/78768b250943?raw)