---
title: "Bulk Remove Companies from Watchlist"
method: POST
path: "/watchlist/companies/bulk-remove/"
tags: ["Watchlist"]
---

# Bulk Remove Companies from Watchlist

`POST /watchlist/companies/bulk-remove/`

## Request

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

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

---
Removes up to 100 companies from the authenticated user's watchlist in a single request. Companies not in the watchlist are silently skipped.

## Request body

- BulkWatchlist
  - `company_ids` integer[], required: A list of company IDs (1–100) to add or remove from the watchlist.

## Response `200`

Companies successfully removed.

- BulkWatchlistResponse
  - `status` string, required: Indicates the status of the operation (e.g., 'success', 'error').
  - `message` string, required: A human-readable message describing the outcome.
  - `company_ids` integer[]: The IDs of the companies affected by the action.

## Other responses

- `400`: Validation error.
- `401`: Authentication credentials were not provided or are invalid.
- `403`: Forbidden. The watchlist is locked by an administrator.
- `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/55935bdabd20?raw)