# Firmoscop API API

**Canonical:** https://apis.io/apis/firmoscop-ro/firmoscop-api-api/  
**Provider:** Firmoscop — https://apis.io/providers/firmoscop-ro/  
**Base URL:** https://firmoscop.ro  
**Documentation:** https://firmoscop.ro/developers

Firmoscop API API is one of 2 APIs that [Firmoscop](https://apis.io/providers/firmoscop-ro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Verificarea firmelor românești, AI-native. Profil de firmă, căutare, grupuri de firme și scor de bonitate — GRATUIT din indexul propriu (ANAF, ONRC, Ministerul Finanțelor, SEAP). Verdictul complet de risc comercial (verde/galben/roșu) e calculat DETERMINIST din surse publice (ANAF, MF, portalul inst

## Operations (35)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/keys/register` | Creează cont gratuit pe email (10 credite pe lună) |
| POST | `/api/v1/keys/rotate` | Emite/rotește cheia API `fk_…` (afișată o singură dată) |
| GET | `/api/v1/me` | Contul curent: email, credite, firme urmărite |
| GET | `/api/v1/search` | Caută firme după nume (fără credit) |
| GET | `/api/v1/suggest` | Sugestii publice după nume (fără cont, limitat pe IP) |
| GET | `/api/v1/company/{cui}` | Profil de firmă (identitate, stare, bilanțuri, bonitate, reprezentanți) — fără credit |
| GET | `/api/v1/company/{cui}/connections` | Grup de firme (rețea prin reprezentanți comuni) — fără credit |
| GET | `/api/v1/verify/{cui}` | Verifică o firmă după CUI (1 credit) |
| POST | `/api/v1/verify/batch` | Verifică până la 20 de firme într-o cerere (1 credit / firmă reușită) |
| GET | `/api/v1/company/{cui}/financials` | Bilanțuri multi-anuale (fără credit) |
| GET | `/api/v1/company/{cui}/financials.csv` | Bilanțuri multi-anuale ca CSV pentru Excel (fără credit) |
| GET | `/api/v1/company/{cui}/contracts` | Contracte publice câștigate, paginat (fără credit) |
| GET | `/api/v1/company/{cui}/history` | Istoric de modificări ONRC — mențiuni (fără credit) |
| GET | `/api/v1/company/{cui}/debts` | Restanțe la buget (ANAF, lista datornicilor) — fără credit |
| GET | `/api/v1/vat/{cui}` | Stare fiscală: TVA / inactiv fiscal / e-Factura (fără credit) |
| GET | `/api/v1/vies/{country}/{vat}` | Validare TVA intracomunitar prin VIES (fără credit) |
| GET | `/api/v1/caen` | Caută coduri CAEN după cod sau denumire (fără credit) |
| GET | `/api/v1/caen/{code}` | Denumirea unui cod CAEN (fără credit) |
| GET | `/api/v1/pricing` | Prețuri citibile de mașină (public, fără cheie) — pentru top-up autonom al agenților |
| GET | `/api/v1/companies` | Liste filtrate de firme (1 credit la 25 de firme) |
| GET | `/api/v1/statistici` | Statisticile unei selecții, cu etalonul național (gratuit, cere cont) |
| GET | `/api/v1/firme-noi/export.csv` | Firmele înmatriculate într-o zi, ca CSV (gratuit, cere cont) |
| GET | `/api/v1/firme-noi/alerts` | Segmentele de firme noi la care ești abonat |
| POST | `/api/v1/firme-noi/alerts` | Abonează-te la firmele noi dintr-un segment (digest zilnic pe email) |
| DELETE | `/api/v1/firme-noi/alerts` | Renunță la un segment |
| GET | `/api/v1/companies/export.csv` | Descarcă lista de prospectare ca CSV (primele 50 de rânduri gratuite, apoi 1 credit la 25) |
| GET | `/api/v1/watchlist` | Firmele urmărite (re-verificate zilnic) |
| POST | `/api/v1/watchlist` | Adaugă o firmă în lista de urmărire |
| DELETE | `/api/v1/watchlist/{cui}` | Scoate o firmă din lista de urmărire |
| POST | `/api/v1/webhooks` | Creează un webhook (notificare push la schimbare de verdict) |
| GET | `/api/v1/webhooks` | Listează webhook-urile (fără secret) |
| DELETE | `/api/v1/webhooks/{id}` | Șterge un webhook |
| GET | `/api/v1/webhooks/{id}/deliveries` | Jurnalul de livrări al unui webhook (dashboard) |
| GET | `/api/v1/stats` | Statistici publice ale indexului (semnal de acoperire/prospețime) |
| POST | `/mcp` | Endpoint MCP (streamable HTTP, stateless) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/firmoscop-ro/openapi/_original/firmoscop-ro-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/firmoscop-ro/json-schema/firmoscop-ro-company-profile-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmoscop-ro/json-schema/firmoscop-ro-connections-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmoscop-ro/json-schema/firmoscop-ro-stat-bucket-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmoscop-ro/json-schema/firmoscop-ro-financial-year-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmoscop-ro/json-schema/firmoscop-ro-verify-report-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmoscop-ro/json-schema/firmoscop-ro-suggest-hit-schema.json

## Other Firmoscop APIs (1)

- [Firmoscop API](https://apis.io/apis/firmoscop-ro/firmoscop-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/firmoscop-ro/firmoscop-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/firmoscop-ro/.