---
title: "Adaugă o firmă în lista de urmărire"
method: POST
path: "/api/v1/watchlist"
tags: ["Monitorizare"]
---

# Adaugă o firmă în lista de urmărire

`POST /api/v1/watchlist`

## Request

- Base URL: `https://firmoscop.ro`
- URL: `https://firmoscop.ro/api/v1/watchlist`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `fs_session`

## Request body

- object
  - `cui` string, required

## Response `201`

Adăugată (sau era deja în listă).

## Other responses

- `400`: Eroare — corp JSON { error, message } în limbaj natural.
- `401`: Eroare — corp JSON { error, message } în limbaj natural.
- `409`: Lista e plină — error: watchlist_full, cu count, limit și plan. Contul gratuit urmărește până la 25 de firme; scoate una cu DELETE /api/v1/watchlist/{cui}.

---

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