# apifirme

> API și server MCP (pentru asistenți AI) cu date despre firmele din România: date de
> identificare, stare, TVA, situații financiare anuale, firme nou înregistrate și cursul de
> referință BNR. Datele provin din registre oficiale (ONRC, ANAF, Ministerul Finanțelor,
> BNR); fiecare răspuns spune din ce sursă și de la ce dată este informația. Operat de
> Cubus Arts S.R.L., Sibiu, România. Contact: dev@apifirme.dev.

API-ul este REST, răspunde în JSON și cere o cheie în antetul `Authorization: Bearer <cheie>`.
Erorile respectă RFC 7807 (`application/problem+json`). Un CUI se scrie cu sau fără prefixul RO.
Persoanele fizice care desfășoară o activitate economică (PFA, întreprinderi individuale și
familiale, profesii liberale) sunt servite ca firmele, cu ce publică registrele despre ele;
câmpul `persoana_fizica` spune ce fel de înregistrare este. CNP-ul nu este păstrat și nu este servit.

## Pagini

- [Pagina principală](https://apifirme.dev/index.md): ce conține baza de date acum, în cifre numărate, și lista cererilor API
- [Documentația API](https://apifirme.dev/docs.md): fiecare cerere cu parametri, răspunsuri și câmpuri; descrierea OpenAPI 3.1 este la https://api.apifirme.dev/openapi.json
- [Prețuri](https://apifirme.dev/preturi.md): planurile și limitele lor
- [De unde vin datele și cum sunt ținute la zi](https://apifirme.dev/despre-date.md): Sursele oficiale din care apifirme ia datele despre firme — ONRC, ANAF, Ministerul Finanțelor, BNR — cât de des se reîmprospătează, ce înseamnă fiecare dată din răspuns și ce date nu sunt servite.
- [Termeni și condiții](https://apifirme.dev/termeni.md): Condițiile în care Cubus Arts S.R.L. oferă serviciul apifirme: conturi, planuri, plată, utilizare permisă, limitarea răspunderii.
- [Politica de confidențialitate](https://apifirme.dev/confidentialitate.md): Ce date cu caracter personal prelucrează apifirme despre clienții săi și despre persoanele din registrele publice, în ce scop și cu ce drepturi.
- [Cookie-uri](https://apifirme.dev/cookies.md): Paginile publice ale apifirme nu folosesc cookie-uri și nu încarcă nimic de la terți; contul folosește un singur cookie, strict necesar.

## In English

- [API documentation](https://apifirme.dev/docs.md?lang=en): every request with its parameters, responses and fields; the OpenAPI 3.1 description in English is at https://api.apifirme.dev/openapi.json?lang=en
- [Where the data comes from](https://apifirme.dev/despre-date.md?lang=en): the official sources, how often they are refreshed, and what is not available
- Contact: dev@apifirme.dev, for questions, proposals and errors in the data

## Pentru asistenți AI

- Server MCP (Model Context Protocol, transport Streamable HTTP, revizia 2026-07-28 și cele din 2025): `https://api.apifirme.dev/mcp`. Autentificare OAuth 2.1 (asistentul își trimite utilizatorul să intre în cont) sau o cheie API în antetul `Authorization`. Unelte: `find_company`, `lookup_company`, `check_invoice`, `get_financials`, `get_company_events`, `get_fx_rate`, `count_new_companies`, `list_new_companies`. Se numără doar apelurile de unelte.
- [Cum se conectează un asistent](https://apifirme.dev/ai.md): pașii pentru Claude, ChatGPT, Perplexity, Mistral, Grok, Copilot, Cursor, VS Code, Gemini CLI și alții; în engleză la https://apifirme.dev/ai.md?lang=en

## Webhooks

- Planurile care includ lista firmelor noi pot primi fiecare firmă nouă la o adresă `https` a lor (eveniment `company.registered`, semnat cu HMAC-SHA256); adresa și filtrele (coduri CAEN, județe, persoane juridice sau fizice) se înregistrează în cont. Descrierea este în documentație, la „Webhooks”.

## Cereri API

- `GET https://api.apifirme.dev/rest/v1/companies/{cui}`: datele unei firme
- `POST https://api.apifirme.dev/rest/v1/companies/batch`: până la 100 de firme într-o cerere, după CUI (`{"cuis": [...]}`)
- `GET https://api.apifirme.dev/rest/v1/companies/search?denumire=...`: găsește o firmă fără CUI, după denumire (opțional `judet`) sau după numărul din registrul comerțului (`nr_reg_com=J32/508/2000`); cel mult 10 firme
- `GET https://api.apifirme.dev/rest/v1/invoice-check/{cui}`: verificarea dinaintea facturării (există, TVA, TVA la încasare, inactivă, e-Factura)
- `GET https://api.apifirme.dev/rest/v1/companies/{cui}/events`: schimbările observate la o firmă (TVA, inactivare, radiere, denumire, adresă, cod CAEN, e-Factura)
- `GET https://api.apifirme.dev/rest/v1/companies/{cui}/financials` și `/financials/{an}`: situațiile financiare anuale
- `GET https://api.apifirme.dev/rest/v1/registrations`: firmele nou înregistrate, și persoanele fizice care desfășoară o activitate economică, cu filtre (`days`, `registered_after`, `caen`, `caen_prefix`, `judet`, `forma_juridica`, `persoana_fizica`, `limit`) și `cursor`; cine întreabă zilnic păstrează ultimul `next_cursor` și continuă de la el. Filtrul `persoana_fizica` (`true` doar persoanele fizice, `false` doar cele juridice) ține de ce se știe în momentul cererii: o înregistrare încă neclasificată nu apare cu niciuna dintre valori și nu revine în listă când este clasificată, așa că cine urmărește lista cu `persoana_fizica=false` o poate pierde; fără filtru apare tot
- `GET https://api.apifirme.dev/rest/v1/registrations/count`: câte firme noi corespund unui filtru
- `GET https://api.apifirme.dev/rest/v1/fx/latest`, `/fx/{data}`, `/fx/series`, `/fx/convert`: cursul de referință BNR
- `GET https://api.apifirme.dev/rest/v1/validate/cui/{cui}`: verificarea cifrei de control, fără cheie