---
title: "Get User's Watchlist"
method: GET
path: "/watchlist/"
tags: ["Watchlist"]
---

# Get User's Watchlist

`GET /watchlist/`

## Request

- Base URL: `https://api.financialreports.eu`
- URL: `https://api.financialreports.eu/watchlist/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

**Access Level Required:** Requires **Standard Access (Level 1)**.

---
Fetches all companies currently in the authenticated user's watchlist. Results are paginated.

## Response `200`

Successfully retrieved the watchlist.

- WatchlistPage: Paginated watchlist envelope: the standard GlobalCustomPagination fields plus the `is_locked` flag the watchlist view appends to the page.
  - `count` integer, required: Total number of companies on the watchlist.
  - `next` string, uri, nullable, required: URL of the next page of results, or null on the last page.
  - `previous` string, uri, nullable, required: URL of the previous page of results, or null on the first page.
  - `results` WatchlistCompany[], required: Companies on the current page.
    - `id` integer, required: The unique identifier of the company.
    - `name` string, required: The name of the company.
  - `is_locked` boolean, required: Whether the watchlist is locked by an administrator.

## Other responses

- `401`: Authentication credentials were not provided or are invalid.
- `403`: Missing or invalid API key, or the plan does not include this endpoint.
- `429`: Rate limit, plan quota or spend cap reached.

---

[API](https://skmtc.dev/financialreports/apis/financialfilings-api.md) · [All operations](https://skmtc.dev/financialreports/apis/financialfilings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/financialreports/apis/financialfilings-api/revisions/a780251d6b05?raw)