---
title: "Bulk Add Companies to Watchlist"
method: POST
path: "/watchlist/companies/bulk-add/"
tags: ["Watchlist"]
---

# Bulk Add Companies to Watchlist

`POST /watchlist/companies/bulk-add/`

## Request

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

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

---
Adds up to 100 companies to the authenticated user's watchlist in a single request. Companies already 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 added.

- 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/a780251d6b05?raw)