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

# List Watchlists

`GET /api/v1/watchlists`

## Request

- Base URL: `https://nordicfinancialnews.com`
- URL: `https://nordicfinancialnews.com/api/v1/watchlists`
- Auth: HTTP bearer

Returns all watchlists belonging to the authenticated user, ordered by position (ascending) then creation date. Each watchlist includes a company count but not the full company list. Use the Get Watchlist Details endpoint to retrieve companies. Requires the `read:watchlist` scope.

## Headers

- `If-None-Match` string
- `If-Modified-Since` string

## Response `200`

Watchlists retrieved successfully

- object
  - `watchlists` WatchlistSummary[], required
    - `id` string, required: Unique watchlist identifier
    - `name` string, required: User-defined watchlist name
    - `position` integer, required: Display order (lower values appear first)
    - `company_count` integer, required: Number of companies in the watchlist
    - `created_at` string, date-time: When the watchlist was created
    - `updated_at` string, date-time: When the watchlist was last modified

## Other responses

- `304`: Not Modified
- `401`: Unauthorized

---

[API](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api.md) - [All operations](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nordicfinancialnews/apis/nordic-financial-news-api/revisions/aa48db8c82fc?raw)