Documentația API
API-ul este REST și răspunde în JSON. Descrierea completă, în format OpenAPI 3.1, este la https://api.apifirme.dev/openapi.json; pagina aceasta este generată din ea.
Autentificare
Fiecare cerere, în afara celor de validare, cere o cheie API în antetul Authorization:
curl https://api.apifirme.dev/rest/v1/companies/13548146 \
-H "Authorization: Bearer af_live_..."
În locul lui af_live_... pui cheia ta, așa cum ți-a fost arătată când ai creat-o în cont. În adresele de mai jos, {cui} este CUI-ul firmei, de exemplu 13548146, iar {year} anul: exemplele curl au deja valori reale și pot fi rulate ca atare. O cerere în care a rămas un {cui} sau un af_live_... primește 400 cu placeholder-left-in, care spune ce era de înlocuit.
O cheie care lipsește, este greșită sau a fost revocată primește 401. Cheile unui cont suspendat primesc 403 cu account-suspended; o astfel de cerere nu se numără.
Limite
Fiecare răspuns spune cât a mai rămas din limite: x-ratelimit-limit, x-ratelimit-remaining și x-ratelimit-reset pentru cererile pe minut, x-quota-limit și x-quota-remaining pentru cele ale lunii. O cerere peste limită primește 429 cu antetul Retry-After și nu se numără. Peste numărul lunar de cereri al planului mai sunt admise încă 5 %, fără cost; abia după ele cererile sunt refuzate.
Limitele sunt ale contului, nu ale cheii: toate cheile unui cont, cu tot cu asistenții AI conectați, împart cererile pe minut, firmele căutate pe loc la ANAF, căutările și cererile lunii. Antetele de mai sus spun cât a mai rămas contului.
Cereri condiționate
Fiecare răspuns 200 are un antet ETag. O cerere care îl trimite înapoi în If-None-Match primește 304 fără corp dacă răspunsul nu s-a schimbat; și ea se numără ca o cerere.
Erori
Erorile respectă RFC 7807: tipul de conținut este application/problem+json, iar corpul are type, title, status și detail. type identifică felul erorii, de exemplu https://apifirme.dev/problems/invalid-cui.
Pentru asistenți AI
Aceleași date sunt disponibile ca unelte prin Model Context Protocol, la https://api.apifirme.dev/mcp (transport Streamable HTTP): lookup_company, check_invoice, get_financials, get_company_events, get_fx_rate, count_new_companies și list_new_companies. Un asistent își trimite utilizatorul să intre în cont (OAuth 2.1); un program poate trimite aceeași cheie API în antetul Authorization. Se numără doar apelurile de unelte, fiecare ca o cerere; conectarea și lista de unelte nu se numără. Pașii pentru fiecare asistent sunt la https://apifirme.dev/ai.
Surse
Fiecare firmă și fiecare situație financiară are un câmp sources: din ce registru vine informația, din ce set de date și când a fost preluată prima și ultima oară.
Firme
Datele unei firme, după CUI.
GET /rest/v1/companies/{cui}
Datele unei firme. Întoarce firma cu acest CUI. Dacă firma nu este încă în baza de date, este căutată pe loc la ANAF: răspunsul vine în aceeași cerere sau, dacă sursa întârzie, cu 202 și antetul Retry-After. Răspunde la fel pentru persoanele fizice care desfășoară o activitate economică (PFA, întreprinderi individuale și familiale, profesii liberale), cu ce publică registrele despre ele; persoana_fizica spune ce fel de înregistrare este. O înregistrare căreia îi lipsesc încă datele de la ANAF este completată pe loc, ca una care nu este în baza de date; dacă nu are încă o denumire și asta nu se poate acum, răspunsul este tot cel pentru o înregistrare care nu este în baza de date (202, 429 sau 503), nu una fără denumire. Una care are denumirea din registrul comerțului este întoarsă cu ce spune registrul.
| Parametru | Unde | Descriere |
|---|---|---|
cui | în cale, obligatoriu | Codul unic de identificare, cu sau fără prefixul RO, de exemplu 13548146. |
curl https://api.apifirme.dev/rest/v1/companies/13548146 \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Firma. |
202 | Firma este căutată la ANAF și nu a sosit la timp. Repetă cererea după numărul de secunde din Retry-After. Nu se numără ca cerere. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
404 | Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
503 | Firma nu este în baza de date și ANAF nu a putut fi întrebat acum. Nu se numără ca cerere. |
Răspunsul 200 este un obiect Company:
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg | Codul unic de identificare. |
denumire | text sau nimic | Denumirea, scrisă pentru cititor; cum o scrie sursa este în oficial. |
nr_reg_com | text sau nimic | Numărul de înregistrare în registrul comerțului. |
adresa_completa | text sau nimic | Adresa firmei, într-un singur text, scrisă pentru cititor: domiciliul fiscal, cum îl dă ANAF, iar la o firmă despre care ANAF nu a răspuns, sediul din registrul comerțului. Unde ANAF are domiciliul fiscal în altă parte decât sediul social, județul, localitatea și codul poștal sunt tot ale lui; sediul social este în sediu_social. Cum o scrie sursa este în oficial. |
localitate | text sau nimic | Localitatea adresei firmei, scrisă pentru cititor; cum o scrie sursa este în oficial. |
judet | text sau nimic | Codul județului adresei firmei: SB, B, ... Filtrele după județ (firmele noi, căutarea, webhooks) merg după județul sediului social (sediu_social.judet), care este același la aproape toate firmele. |
cod_postal | text sau nimic | Codul poștal al adresei firmei, din șase cifre. null unde sursa nu are unul în uz (codurile de dinainte de 2003, valori incomplete). |
stare | text sau nimic | Starea, într-un cuvânt: FUNCTIUNE, SUSPENDARE, REORGANIZARE JUDICIARA, INSOLVENTA, DIZOLVARE, LICHIDARE, FALIMENT, RADIERE. |
stare_detalii | text sau nimic | Starea înregistrării la ANAF, cu ziua ei, scrisă pentru cititor: „Dizolvare fără lichidare (fuziune) din data 01.06.2024”, „Suspendare activitate din data 01.03.2025”, „Înregistrat din data 23.11.2000”. Spune mai mult decât stare (de pildă că firma a fost absorbită la o fuziune); cum o scrie ANAF este în oficial.stare_detalii. null unde ANAF nu dă nimic. |
persoana_fizica | da/nu sau nimic | false pentru o persoană juridică, true pentru o persoană fizică care desfășoară o activitate economică (PFA, întreprindere individuală sau familială, profesie liberală), null cât timp sursele nu permit să se spună. |
forma_juridica_cod | text sau nimic | Forma juridică din registrul comerțului: SRL, SA, ... |
forma_juridica | text sau nimic | Forma juridică așa cum o scrie ANAF. |
caen | număr întreg sau nimic | Codul CAEN al activității principale (sursa: ANAF). |
caen_denumire | text sau nimic | Denumirea codului CAEN, în clasificarea în vigoare. |
scp_tva | da/nu | Dacă este înregistrată în scopuri de TVA. |
data_inceput_tva | dată sau nimic | De când este înregistrată în scopuri de TVA. |
data_sfarsit_tva | dată sau nimic | Până când a fost înregistrată, dacă nu mai este. |
tva_incasare | da/nu | Dacă aplică TVA la încasare. |
split_tva | da/nu | Dacă aplică plata defalcată a TVA. |
e_factura | da/nu | Dacă este înscrisă în registrul RO e-Factura. |
status_inactiv | da/nu | Dacă este declarată inactivă fiscal. |
data_inactivare | dată sau nimic | De când este inactivă. |
data_inregistrare | dată sau nimic | Data înregistrării fiscale (sursa: ANAF). |
data_inmatriculare | dată sau nimic | Data intrării în registrul comerțului (sursa: ONRC). |
telefon | text sau nimic | Telefonul declarat la ANAF, cum îl scrie ANAF. null și unde ANAF nu are decât o valoare fără nicio cifră în afară de 0 („0”, „0/0”, „nedeclarat”). |
fax | text sau nimic | Faxul declarat la ANAF, cum îl scrie ANAF. null și unde ANAF nu are decât o valoare fără nicio cifră în afară de 0 („0”, „0/0”, „nedeclarat”). |
web | text sau nimic | Adresa web declarată la registrul comerțului. |
euid | text sau nimic | Identificatorul unic european (sursa: ONRC). |
sediu_secundar | da/nu | Dacă este sediul secundar al unei firme, înregistrat la ANAF cu CUI propriu. |
updated_on | dată sau nimic | Ziua în care s-a schimbat ultima oară ceva în datele firmei. |
changed_on | dată sau nimic | Ziua în care s-a schimbat ultima oară o valoare deja cunoscută a firmei; null dacă nu s-a schimbat nimic de când o avem. Se urmărește tot ce dau sursele: orice câmp al răspunsului ANAF (denumirea, adresele, telefonul, faxul, codul poștal, starea, codul CAEN, TVA, TVA la încasare, plata defalcată, inactivitatea, e-Factura), datele din registrul comerțului și obligațiile fiscale. Nu este o schimbare o informație care lipsea și a fost completată, nici una scrisă doar altfel (litere mari, spații, ş sau ș). |
checked_on | dată sau nimic | Ziua în care a fost întrebat ultima oară ANAF despre firmă; null dacă încă nu. |
sediu_social | obiect | Sediul social, cum îl dau ANAF și registrul comerțului: judet, localitate, strada, numar, detalii și cod_postal, scrise pentru cititor (cum le scrie sursa sunt în oficial.sediu_social). La aproape toate firmele este aceeași adresă cu cea de mai sus; diferă unde domiciliul fiscal declarat la ANAF este în altă parte. |
obligatii_fiscale | FiscalObligations sau nimic | Obligațiile fiscale la care contribuabilul era înregistrat (vectorul fiscal), din lista pe care Ministerul Finanțelor o publică o dată pe an: starea din ziua listei (la_data), nu cea de azi. null când nu se cunosc: firma nu apare în listă sau a fost preluată după ce lista a fost importată. Nu înseamnă că nu are obligații. |
stari_registru | listă | Toate stările și mențiunile din registrul comerțului, fiecare cu cod și denumire. |
caen_autorizate | listă sau nimic | Activitățile pentru care firma este autorizată, din datele deschise ale registrului comerțului: fiecare cu cod, versiune (a clasificării CAEN în care a fost declarată: 3 este cea din 2025, 2 cea din 2008, 1 cea din 2003, 0 cea din 1998) și denumire, cea mai nouă clasificare întâi. Registrul păstrează și ce a fost declarat în clasificările vechi, deci aceeași activitate poate apărea cu coduri din mai multe versiuni. null când nu sunt cunoscute (firma nu este în setul registrului), ceea ce nu înseamnă că nu are niciuna. |
sources | listă de Source | Din ce surse vin datele firmei și de când. |
oficial | obiect | Denumirea (denumire), localitatea (localitate), adresa (adresa_completa), codul poștal (cod_postal), starea la ANAF (stare_detalii) și, din sediul social, localitatea, strada, detaliile și codul poștal (sediu_social) așa cum le scrie sursa, de obicei cu majuscule (un cod poștal care nu are șase cifre este dat mai sus ca null, aici cum este). În câmpurile de mai sus sunt scrise pentru cititor: se schimbă doar literele mari și mici, spațiile, punctuația, ş și ţ (scrise cu virgulă dedesubt) și forma câtorva prescurtări (STR devine Str., NR. devine nr.); niciun cuvânt și niciun număr nu lipsește și nu își schimbă locul. Forma juridică rămâne cum a fost înregistrată (SRL sau S.R.L.). |
POST /rest/v1/companies/batch
Mai multe firme într-o cerere. Până la 100 de CUI-uri într-o singură cerere, cu răspuns din ce este deja în baza de date, pentru orice fel de înregistrare, persoanele fizice incluse. Costă atâtea cereri câte înregistrări întoarce în data, și cel puțin una. Un CUI care nu este încă în baza de date apare în not_stored, iar unul din baza de date căruia îi lipsesc încă datele de la ANAF (de pildă denumirea, adresa, înregistrarea în scopuri de TVA) apare în incomplete. Acestea nu costă nimic și pot fi cerute singure, cu GET /rest/v1/companies/{cui}, care le caută pe loc la ANAF. Pentru limita pe minut, o cerere cu mai multe firme este o singură cerere.
Corpul cererii este un obiect BatchRequest:
| Câmp | Tip | Descriere |
|---|---|---|
cuis | listă | Între 1 și 100 de CUI-uri, ca text sau ca număr, cu sau fără prefixul RO. |
curl -X POST https://api.apifirme.dev/rest/v1/companies/batch \
-H "Authorization: Bearer af_live_..." \
-H "Content-Type: application/json" \
-d '{"cuis": ["13548146", "RO4221306"]}'
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Firmele găsite și ce este cu celelalte CUI-uri. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect BatchResult:
| Câmp | Tip | Descriere |
|---|---|---|
data | listă de Company | Firmele găsite, în ordinea în care au fost cerute. |
not_stored | listă | CUI-urile valide care nu sunt încă în baza de date. Nu costă nimic; cerute singure, sunt căutate la ANAF. |
incomplete | listă | CUI-urile din baza de date cărora le lipsesc încă datele de la ANAF (de pildă denumirea, adresa, înregistrarea în scopuri de TVA). Nu costă nimic; cerute singure, sunt completate pe loc de la ANAF. |
invalid | listă | Ce nu este un CUI valid, așa cum a fost primit. |
GET /rest/v1/companies/search
Caută o firmă fără CUI. Găsește o firmă după denumire sau după numărul din registrul comerțului, pentru cine nu îi știe CUI-ul. Se dă exact unul dintre denumire și nr_reg_com. După denumire vin întâi firmele care se numesc chiar așa, cu sau fără forma juridică („dedeman” găsește „DEDEMAN SRL”), apoi cele a căror denumire începe așa, apoi cele care conțin toate cuvintele, în orice ordine. Diacriticele și majusculele nu contează, iar firmele în funcțiune vin înaintea celorlalte. Răspunsul are cel mult 10 firme, cu câteva câmpuri fiecare, și nu are o pagină următoare: more spune că se potrivesc și altele, iar atunci ajută județul sau o denumire mai exactă. Datele complete ale unei firme se cer cu CUI-ul ei. Persoanele fizice care desfășoară o activitate economică sunt găsite ca firmele; sediile secundare nu apar. O căutare costă o cerere și are o limită proprie pe minut, după plan; peste ea răspunsul este 429 cu searches-limited.
| Parametru | Unde | Descriere |
|---|---|---|
denumire | în interogare | Denumirea firmei sau o parte din ea: cel puțin un cuvânt de trei litere sau cifre, în afara formei juridice. |
nr_reg_com | în interogare | Numărul din registrul comerțului, în forma veche (J32/508/2000) sau în cea nouă (J2000000508324), oricum ar fi el păstrat la noi. Se pot căuta și numerele persoanelor fizice, care încep cu F. |
judet | în interogare | Doar împreună cu denumire: codul unui județ, ca pe plăcuțele de înmatriculare (SB, B pentru București). |
curl https://api.apifirme.dev/rest/v1/companies/search \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Firmele găsite. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect SearchResult:
| Câmp | Tip | Descriere |
|---|---|---|
data | listă de CompanyFound | Firmele găsite, cele mai apropiate întâi: cel mult 10. |
more | da/nu | true dacă se potrivesc și alte firme decât cele întoarse. |
GET /rest/v1/companies/{cui}/events
Ce s-a schimbat la o firmă. Schimbările observate la firmă de când o urmărim, cea mai recentă întâi (cel mult 200): înregistrarea sau radierea din scopuri de TVA, TVA la încasare, plata defalcată a TVA, declararea ca inactivă și reactivarea, radierea, schimbarea stării, a denumirii, a adresei sau a codului CAEN, RO e-Factura. O schimbare este notată când răspunsul ANAF despre firmă diferă de cel dinainte; ce s-a întâmplat înainte de primul nostru răspuns de la ANAF nu apare, iar lista este goală dacă nu s-a observat nimic. La persoanele fizice și la înregistrările încă neclasificate, o schimbare rămâne în listă trei ani de la data la care a fost observată. Că o firmă este nouă nu este un eveniment aici: pentru asta există registrations.
| Parametru | Unde | Descriere |
|---|---|---|
cui | în cale, obligatoriu | Codul unic de identificare, cu sau fără prefixul RO, de exemplu 13548146. |
curl https://api.apifirme.dev/rest/v1/companies/13548146/events \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Schimbările observate la firmă. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
404 | Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect EventsList:
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg | CUI-ul firmei. |
events | listă de Event | Schimbările observate, cea mai recentă întâi. |
GET /rest/v1/invoice-check/{cui}
Verificare înainte de facturare. Răspunde, într-o singură cerere, la ce vrea să știe un program de facturare despre un client: există, este înregistrat în scopuri de TVA, aplică TVA la încasare, este inactiv fiscal, este în registrul RO e-Factura. Dacă ultimul răspuns al ANAF despre firmă este mai vechi de 24 de ore, firma este întrebată din nou pe loc; checked_on spune din ce zi sunt datele. Un CUI valid pe care ANAF nu îl cunoaște primește 200 cu exists: false. O înregistrare fără denumire căreia îi lipsesc încă datele de la ANAF este întrebată pe loc; dacă asta nu se poate acum, răspunsul este cel pentru un CUI care nu este în baza de date (202, 429 sau 503).
| Parametru | Unde | Descriere |
|---|---|---|
cui | în cale, obligatoriu | Codul unic de identificare, cu sau fără prefixul RO, de exemplu 13548146. |
curl https://api.apifirme.dev/rest/v1/invoice-check/13548146 \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Rezultatul verificării. |
202 | Firma este căutată la ANAF și nu a sosit la timp. Repetă cererea după numărul de secunde din Retry-After. Nu se numără ca cerere. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
404 | Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
503 | Firma nu este în baza de date și ANAF nu a putut fi întrebat acum. Nu se numără ca cerere. |
Răspunsul 200 este un obiect InvoiceCheck:
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg | Codul unic de identificare. |
denumire | text sau nimic | Denumirea, scrisă pentru cititor; cum o scrie sursa este în oficial. |
exists | da/nu | Dacă ANAF cunoaște un contribuabil cu acest CUI. |
valid_for_invoicing | da/nu | Dacă firma există, nu este radiată și nu este inactivă fiscal. |
vat_registered | da/nu | Dacă este înregistrată în scopuri de TVA. |
vat_number | text sau nimic | Codul de TVA (RO urmat de CUI), dacă este înregistrată în scopuri de TVA. |
vat_on_collection | da/nu | Dacă aplică TVA la încasare. |
split_vat | da/nu | Dacă aplică plata defalcată a TVA. |
inactive | da/nu | Dacă este declarată inactivă fiscal. |
struck_off | da/nu | Dacă este radiată. |
efactura_registered | da/nu | Dacă este înscrisă în registrul RO e-Factura. |
stare | text sau nimic | Starea, într-un cuvânt, ca la datele firmei. |
checked_on | dată sau nimic | Ziua în care a răspuns ANAF ultima oară despre firmă. |
oficial | obiect sau nimic | Denumirea (denumire) așa cum o scrie sursa, de obicei cu majuscule; null când ANAF nu cunoaște CUI-ul. |
Situații financiare
Situațiile financiare anuale publicate de Ministerul Finanțelor și, pentru cele care lipsesc din datele ministerului, cele din serviciul web al ANAF.
GET /rest/v1/companies/{cui}/financials
Situațiile financiare ale unei firme. Toate situațiile financiare anuale ale firmei, cel mai recent an întâi. Lista este goală dacă nu există niciuna.
| Parametru | Unde | Descriere |
|---|---|---|
cui | în cale, obligatoriu | Codul unic de identificare, cu sau fără prefixul RO, de exemplu 13548146. |
curl https://api.apifirme.dev/rest/v1/companies/13548146/financials \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Situațiile financiare ale firmei. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
404 | Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect FinancialsList:
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg | CUI-ul firmei. |
financials | listă de Statement | Situațiile financiare, cel mai recent an întâi. |
GET /rest/v1/companies/{cui}/financials/{year}
Situația financiară dintr-un an.
| Parametru | Unde | Descriere |
|---|---|---|
cui | în cale, obligatoriu | Codul unic de identificare, cu sau fără prefixul RO, de exemplu 13548146. |
year | în cale, obligatoriu | Anul situației financiare, de exemplu 2025. |
curl https://api.apifirme.dev/rest/v1/companies/13548146/financials/2025 \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Situația financiară a anului. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
404 | Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect Statement:
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg | CUI-ul firmei. |
an | număr întreg | Anul situației financiare. |
tip_raportare | text | Tipul de raportare al Ministerului Finanțelor: UU (bilanț prescurtat), BL_BS_SL, IR (IFRS), ONG, ... Serviciul web al ANAF nu dă tipul: la o situație luată de acolo este dedus din indicatorii ei, iar unde mai multe tipuri au aceiași indicatori este tipul firmei din anul dinainte. |
tip_raportare_descriere | text sau nimic | Ce fel de contribuabili depun acest tip. |
caen | număr întreg sau nimic | Codul CAEN din situația financiară. |
caen_denumire | text sau nimic | Denumirea codului, în clasificarea în vigoare în acel an. |
active_imobilizate | număr întreg sau nimic | Active imobilizate, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
active_circulante | număr întreg sau nimic | Active circulante, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
stocuri | număr întreg sau nimic | Stocuri. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
creante | număr întreg sau nimic | Creanțe. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
casa_banca | număr întreg sau nimic | Casa și conturi la bănci. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
cheltuieli_avans | număr întreg sau nimic | Cheltuieli în avans. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
datorii | număr întreg sau nimic | Datorii. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
venituri_avans | număr întreg sau nimic | Venituri în avans. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
provizioane | număr întreg sau nimic | Provizioane. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
capitaluri_total | număr întreg sau nimic | Capitaluri, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
capital_social | număr întreg sau nimic | Capital subscris vărsat. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
patrimoniul_regiei | număr întreg sau nimic | Patrimoniul regiei. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
cifra_afaceri | număr întreg sau nimic | Cifra de afaceri netă. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
venituri_totale | număr întreg sau nimic | Venituri totale. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
cheltuieli_totale | număr întreg sau nimic | Cheltuieli totale. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
profit_brut | număr întreg sau nimic | Profit brut. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
pierdere_bruta | număr întreg sau nimic | Pierdere brută. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
profit_net | număr întreg sau nimic | Profit net. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
pierdere_neta | număr întreg sau nimic | Pierdere netă. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
nr_mediu_salariati | număr întreg sau nimic | Număr mediu de salariați. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
alti_indicatori | listă | Indicatorii pe care acest tip de raportare îi are în plus, fiecare cu cod, denumire și valoare. |
updated_at | moment | Când s-a schimbat ultima oară situația în baza noastră de date. |
sources | listă de Source | De unde provine situația (setul de date al ministerului și când l-a publicat, sau serviciul web al ANAF) și când am preluat-o. |
Firme noi
Firmele nou înregistrate, pentru cine vrea să afle zilnic ce firme au apărut.
GET /rest/v1/registrations
Firmele nou înregistrate. Firmele înregistrate în perioada cerută, și persoanele fizice care desfășoară o activitate economică, în ordinea în care au fost indexate, cu paginare prin cursor. Perioada este limitată de plan; o perioadă mai lungă este refuzată cu 400, nu scurtată pe tăcute. Fiecare pagină are un next_cursor, inclusiv ultima: cât timp more este true, pagina următoare se cere imediat cu cursor=<next_cursor>; când este false, se păstrează ultimul next_cursor și se întreabă din nou cu el a doua zi. Așa nu se pierde nicio firmă: o firmă înregistrată luni poate fi indexată vineri, iar firmele devin vizibile strict în ordinea în care sunt indexate, deci apare după cursorul păstrat. Nu se continuă după data înregistrării și nici după ora propriului ceas. O firmă poate apărea a doua oară: atunci când i se află codul CAEN, județul sau forma juridică după ce a fost indexată (un sfert dintre firmele noi nu au încă un cod CAEN în prima zi). Așa o primește și cine filtrează după ele; se recunoaște după cui. Sediile secundare nu apar. Cu persoana_fizica se cer doar persoanele juridice sau doar cele fizice, după ce se știe în momentul cererii; o înregistrare încă neclasificată când a fost indexată nu apare a doua oară când este clasificată, așa că o vede doar cine urmărește lista fără acest filtru. Planurile care nu includ lista primesc 403.
| Parametru | Unde | Descriere |
|---|---|---|
days | în interogare | Firmele înregistrate în ultimele atâtea zile. Nu împreună cu registered_after. |
registered_after | în interogare | Firmele înregistrate începând cu această zi. |
caen | în interogare | Unul sau mai multe coduri CAEN de patru cifre, despărțite prin virgulă. |
caen_prefix | în interogare | Primele două cifre (diviziunea) sau trei (grupa) ale codului CAEN. |
judet | în interogare | Unul sau mai multe coduri de județ (SB, B), despărțite prin virgulă: județul sediului social. |
forma_juridica | în interogare | Una sau mai multe forme juridice, cu codurile registrului comerțului (SRL, SA), despărțite prin virgulă. |
persoana_fizica | în interogare | true pentru doar persoanele fizice care desfășoară o activitate economică (PFA, întreprinderi individuale și familiale, profesii liberale), false pentru doar persoanele juridice. Fără el, toate, inclusiv înregistrările încă neclasificate. |
limit | în interogare | Câte firme pe pagină, între 1 și 500. Implicit 100. |
cursor | în interogare | Valoarea next_cursor din răspunsul anterior. |
curl https://api.apifirme.dev/rest/v1/registrations?days=7&judet=SB \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | O pagină de firme noi. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect RegistrationsPage:
| Câmp | Tip | Descriere |
|---|---|---|
data | listă de Registration | Firmele, în ordinea în care au fost indexate. |
next_cursor | text | De trimis ca cursor pentru pagina următoare. Este și pe ultima pagină: păstrat și trimis a doua zi, aduce firmele indexate între timp. |
more | da/nu | Dacă după această pagină mai sunt firme. |
filter | obiect | Filtrul aplicat, cu perioada rezultată. |
GET /rest/v1/registrations/count
Numărul firmelor nou înregistrate. Câte firme corespund filtrului. Inclus în orice plan, pe cel mult cea mai lungă perioadă oferită de vreun plan. Fără days sau registered_after se numără ultimele 30 de zile.
| Parametru | Unde | Descriere |
|---|---|---|
days | în interogare | Firmele înregistrate în ultimele atâtea zile. Nu împreună cu registered_after. |
registered_after | în interogare | Firmele înregistrate începând cu această zi. |
caen | în interogare | Unul sau mai multe coduri CAEN de patru cifre, despărțite prin virgulă. |
caen_prefix | în interogare | Primele două cifre (diviziunea) sau trei (grupa) ale codului CAEN. |
judet | în interogare | Unul sau mai multe coduri de județ (SB, B), despărțite prin virgulă: județul sediului social. |
forma_juridica | în interogare | Una sau mai multe forme juridice, cu codurile registrului comerțului (SRL, SA), despărțite prin virgulă. |
persoana_fizica | în interogare | true pentru doar persoanele fizice care desfășoară o activitate economică (PFA, întreprinderi individuale și familiale, profesii liberale), false pentru doar persoanele juridice. Fără el, toate, inclusiv înregistrările încă neclasificate. |
curl https://api.apifirme.dev/rest/v1/registrations/count?days=30&caen_prefix=62 \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Numărul de firme. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect RegistrationsCount:
| Câmp | Tip | Descriere |
|---|---|---|
count | număr întreg | Numărul firmelor care corespund filtrului. |
filter | obiect | Filtrul aplicat, cu perioada rezultată. |
upgrade_required_for_records | da/nu | Dacă lista acestor firme cere un plan mai mare decât cel al cheii. |
Curs BNR
Cursul de referință al Băncii Naționale a României, din 2005.
GET /rest/v1/fx/latest
Ultimul curs publicat.
curl https://api.apifirme.dev/rest/v1/fx/latest \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Cursurile din ultima zi bancară. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
404 | Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect FxDay:
| Câmp | Tip | Descriere |
|---|---|---|
date | dată | Ziua cerută. |
effective_date | dată | Ziua bancară pentru care a fost publicat cursul. |
base | text | Moneda în care sunt exprimate cursurile: RON. |
rates | obiect | Pentru fiecare valută: rate, în lei pentru multiplier unități ale valutei. |
source | obiect | Sursa cursului și când a fost preluat. |
GET /rest/v1/fx/{date}
Cursul dintr-o zi. Pentru o zi în care BNR nu publică (sfârșit de săptămână, sărbătoare) se întoarce cursul ultimei zile bancare dinainte; effective_date spune care este aceea.
| Parametru | Unde | Descriere |
|---|---|---|
date | în cale, obligatoriu | Ziua, de exemplu 2026-10-02. |
curl https://api.apifirme.dev/rest/v1/fx/2026-10-02 \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Cursurile valabile în acea zi. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
404 | Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect FxDay:
| Câmp | Tip | Descriere |
|---|---|---|
date | dată | Ziua cerută. |
effective_date | dată | Ziua bancară pentru care a fost publicat cursul. |
base | text | Moneda în care sunt exprimate cursurile: RON. |
rates | obiect | Pentru fiecare valută: rate, în lei pentru multiplier unități ale valutei. |
source | obiect | Sursa cursului și când a fost preluat. |
GET /rest/v1/fx/series
Cursul unei valute pe o perioadă.
| Parametru | Unde | Descriere |
|---|---|---|
currency | în interogare, obligatoriu | Codul valutei, de exemplu EUR. |
from | în interogare, obligatoriu | Prima zi. |
to | în interogare, obligatoriu | Ultima zi. |
curl https://api.apifirme.dev/rest/v1/fx/series?currency=EUR&from=2026-09-01&to=2026-09-30 \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Cursul din fiecare zi bancară a perioadei. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect FxSeries:
| Câmp | Tip | Descriere |
|---|---|---|
currency | text | Valuta. |
base | text | RON. |
from | dată | Prima zi a perioadei. |
to | dată | Ultima zi a perioadei. |
series | listă | Pentru fiecare zi bancară: date, rate și multiplier. |
GET /rest/v1/fx/convert
Conversie între două valute.
| Parametru | Unde | Descriere |
|---|---|---|
from | în interogare, obligatoriu | Valuta sumei, de exemplu EUR. |
to | în interogare, obligatoriu | Valuta rezultatului, de exemplu RON. |
amount | în interogare, obligatoriu | Suma. |
date | în interogare | Ziua cursului. Implicit azi. |
curl https://api.apifirme.dev/rest/v1/fx/convert?from=EUR&to=RON&amount=100 \
-H "Authorization: Bearer af_live_..."
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Suma convertită la cursul BNR. |
400 | Un parametru lipsește sau nu este valid; detail spune care. Un număr de 13 cifre în loc de CUI este un cod numeric personal (invalid-cui, spus ca atare); un exemplu lipit cu tot cu {cui} sau af_live_... primește placeholder-left-in, care spune ce era de înlocuit. |
401 | Cheia API lipsește sau nu este validă. |
403 | Planul nu include această cerere (upgrade-required; upgrade_url duce la planuri), sau contul cheii este suspendat (account-suspended; o astfel de cerere nu se numără). |
404 | Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request). |
429 | Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere. |
Răspunsul 200 este un obiect FxConversion:
| Câmp | Tip | Descriere |
|---|---|---|
from | text | Valuta sumei. |
to | text | Valuta rezultatului. |
amount | număr | Suma. |
result | număr | Suma convertită. |
rate | număr | Cursul folosit, din from în to. |
date | dată | Ziua cerută. |
effective_date | dată | Ziua bancară a cursului folosit. |
Validare
Verificări care nu au nevoie de cheie.
GET /rest/v1/validate/cui/{cui}
Verifică un CUI. Verifică forma și cifra de control. Nu spune dacă există o firmă cu acest CUI. Fără cheie, gratuit.
Nu cere cheie.
| Parametru | Unde | Descriere |
|---|---|---|
cui | în cale, obligatoriu | Codul unic de identificare, cu sau fără prefixul RO, de exemplu 13548146. |
curl https://api.apifirme.dev/rest/v1/validate/cui/13548146
Răspunsuri:
| Cod | Ce înseamnă |
|---|---|
200 | Rezultatul verificării. |
Răspunsul 200 este un obiect CuiValidation:
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg sau text | CUI-ul ca număr, dacă este valid; altfel textul primit. |
valid | da/nu | Dacă forma și cifra de control sunt corecte. |
Webhooks
Planurile care includ lista firmelor noi pot primi fiecare firmă nouă la o adresă a lor, fără să întrebe. Adresa (doar https) și filtrele (coduri CAEN, județe, persoane juridice sau fizice) se înregistrează în cont; secretul cu care sunt semnate mesajele se arată o singură dată, tot acolo. Tot în cont se văd ultimele livrări, cu rezultatul fiecăreia.
POST company.registered
Trimis la adresa înregistrată în cont, la câteva minute după ce o firmă nouă care corespunde filtrelor webhook-ului a intrat în baza noastră de date. Ca lista firmelor noi, webhook-ul primește și persoanele fizice care desfășoară o activitate economică și înregistrările încă neclasificate (persoana_fizica este true, respectiv null), dacă filtrul „persoane juridice sau fizice” din cont nu le lasă deoparte. O înregistrare încă neclasificată când a fost indexată nu revine în listă doar pentru că este clasificată, așa că un webhook cu „doar persoane juridice” poate să nu o primească niciodată. Antetul X-Apifirme-Signature are forma t=<timp Unix>,v1=<semnătură>; semnătura este HMAC-SHA256, în hexazecimal, peste <t>.<corpul cererii>, cu secretul webhook-ului drept cheie. Orice răspuns 2xx venit în zece secunde confirmă primirea; altfel livrarea se reîncearcă de până la opt ori, cu pauze tot mai lungi, timp de aproape o zi. O adresă care nu a răspuns la timp nu mai este apelată câteva minute; livrările care cad în acest timp așteaptă fără să piardă o încercare, dar nu mai mult decât ar fi durat cele opt încercări. Fiecare firmă are mereu același id, deci o livrare repetată poate fi recunoscută; fiecare webhook primește o firmă o singură dată — prima dată când corespunde filtrelor lui. După cinci livrări la rând abandonate, webhook-ul este oprit; poate fi repornit din cont și primește atunci din nou firmele care nu i-au ajuns, cât timp sunt încă printre firmele noi din planul lui. Din cont se poate trimite oricând un mesaj de probă (test: true).
Corpul este un obiect RegistrationEvent. Verificarea semnăturii, de exemplu în shell:
printf '%s.%s' "$t" "$body" | openssl dgst -sha256 -hmac "$secret"
Rezultatul trebuie să fie egal cu v1 din antet; un t mai vechi de câteva minute poate fi respins.
Structuri
Obiectele la care trimit răspunsurile de mai sus.
Company
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg | Codul unic de identificare. |
denumire | text sau nimic | Denumirea, scrisă pentru cititor; cum o scrie sursa este în oficial. |
nr_reg_com | text sau nimic | Numărul de înregistrare în registrul comerțului. |
adresa_completa | text sau nimic | Adresa firmei, într-un singur text, scrisă pentru cititor: domiciliul fiscal, cum îl dă ANAF, iar la o firmă despre care ANAF nu a răspuns, sediul din registrul comerțului. Unde ANAF are domiciliul fiscal în altă parte decât sediul social, județul, localitatea și codul poștal sunt tot ale lui; sediul social este în sediu_social. Cum o scrie sursa este în oficial. |
localitate | text sau nimic | Localitatea adresei firmei, scrisă pentru cititor; cum o scrie sursa este în oficial. |
judet | text sau nimic | Codul județului adresei firmei: SB, B, ... Filtrele după județ (firmele noi, căutarea, webhooks) merg după județul sediului social (sediu_social.judet), care este același la aproape toate firmele. |
cod_postal | text sau nimic | Codul poștal al adresei firmei, din șase cifre. null unde sursa nu are unul în uz (codurile de dinainte de 2003, valori incomplete). |
stare | text sau nimic | Starea, într-un cuvânt: FUNCTIUNE, SUSPENDARE, REORGANIZARE JUDICIARA, INSOLVENTA, DIZOLVARE, LICHIDARE, FALIMENT, RADIERE. |
stare_detalii | text sau nimic | Starea înregistrării la ANAF, cu ziua ei, scrisă pentru cititor: „Dizolvare fără lichidare (fuziune) din data 01.06.2024”, „Suspendare activitate din data 01.03.2025”, „Înregistrat din data 23.11.2000”. Spune mai mult decât stare (de pildă că firma a fost absorbită la o fuziune); cum o scrie ANAF este în oficial.stare_detalii. null unde ANAF nu dă nimic. |
persoana_fizica | da/nu sau nimic | false pentru o persoană juridică, true pentru o persoană fizică care desfășoară o activitate economică (PFA, întreprindere individuală sau familială, profesie liberală), null cât timp sursele nu permit să se spună. |
forma_juridica_cod | text sau nimic | Forma juridică din registrul comerțului: SRL, SA, ... |
forma_juridica | text sau nimic | Forma juridică așa cum o scrie ANAF. |
caen | număr întreg sau nimic | Codul CAEN al activității principale (sursa: ANAF). |
caen_denumire | text sau nimic | Denumirea codului CAEN, în clasificarea în vigoare. |
scp_tva | da/nu | Dacă este înregistrată în scopuri de TVA. |
data_inceput_tva | dată sau nimic | De când este înregistrată în scopuri de TVA. |
data_sfarsit_tva | dată sau nimic | Până când a fost înregistrată, dacă nu mai este. |
tva_incasare | da/nu | Dacă aplică TVA la încasare. |
split_tva | da/nu | Dacă aplică plata defalcată a TVA. |
e_factura | da/nu | Dacă este înscrisă în registrul RO e-Factura. |
status_inactiv | da/nu | Dacă este declarată inactivă fiscal. |
data_inactivare | dată sau nimic | De când este inactivă. |
data_inregistrare | dată sau nimic | Data înregistrării fiscale (sursa: ANAF). |
data_inmatriculare | dată sau nimic | Data intrării în registrul comerțului (sursa: ONRC). |
telefon | text sau nimic | Telefonul declarat la ANAF, cum îl scrie ANAF. null și unde ANAF nu are decât o valoare fără nicio cifră în afară de 0 („0”, „0/0”, „nedeclarat”). |
fax | text sau nimic | Faxul declarat la ANAF, cum îl scrie ANAF. null și unde ANAF nu are decât o valoare fără nicio cifră în afară de 0 („0”, „0/0”, „nedeclarat”). |
web | text sau nimic | Adresa web declarată la registrul comerțului. |
euid | text sau nimic | Identificatorul unic european (sursa: ONRC). |
sediu_secundar | da/nu | Dacă este sediul secundar al unei firme, înregistrat la ANAF cu CUI propriu. |
updated_on | dată sau nimic | Ziua în care s-a schimbat ultima oară ceva în datele firmei. |
changed_on | dată sau nimic | Ziua în care s-a schimbat ultima oară o valoare deja cunoscută a firmei; null dacă nu s-a schimbat nimic de când o avem. Se urmărește tot ce dau sursele: orice câmp al răspunsului ANAF (denumirea, adresele, telefonul, faxul, codul poștal, starea, codul CAEN, TVA, TVA la încasare, plata defalcată, inactivitatea, e-Factura), datele din registrul comerțului și obligațiile fiscale. Nu este o schimbare o informație care lipsea și a fost completată, nici una scrisă doar altfel (litere mari, spații, ş sau ș). |
checked_on | dată sau nimic | Ziua în care a fost întrebat ultima oară ANAF despre firmă; null dacă încă nu. |
sediu_social | obiect | Sediul social, cum îl dau ANAF și registrul comerțului: judet, localitate, strada, numar, detalii și cod_postal, scrise pentru cititor (cum le scrie sursa sunt în oficial.sediu_social). La aproape toate firmele este aceeași adresă cu cea de mai sus; diferă unde domiciliul fiscal declarat la ANAF este în altă parte. |
obligatii_fiscale | FiscalObligations sau nimic | Obligațiile fiscale la care contribuabilul era înregistrat (vectorul fiscal), din lista pe care Ministerul Finanțelor o publică o dată pe an: starea din ziua listei (la_data), nu cea de azi. null când nu se cunosc: firma nu apare în listă sau a fost preluată după ce lista a fost importată. Nu înseamnă că nu are obligații. |
stari_registru | listă | Toate stările și mențiunile din registrul comerțului, fiecare cu cod și denumire. |
caen_autorizate | listă sau nimic | Activitățile pentru care firma este autorizată, din datele deschise ale registrului comerțului: fiecare cu cod, versiune (a clasificării CAEN în care a fost declarată: 3 este cea din 2025, 2 cea din 2008, 1 cea din 2003, 0 cea din 1998) și denumire, cea mai nouă clasificare întâi. Registrul păstrează și ce a fost declarat în clasificările vechi, deci aceeași activitate poate apărea cu coduri din mai multe versiuni. null când nu sunt cunoscute (firma nu este în setul registrului), ceea ce nu înseamnă că nu are niciuna. |
sources | listă de Source | Din ce surse vin datele firmei și de când. |
oficial | obiect | Denumirea (denumire), localitatea (localitate), adresa (adresa_completa), codul poștal (cod_postal), starea la ANAF (stare_detalii) și, din sediul social, localitatea, strada, detaliile și codul poștal (sediu_social) așa cum le scrie sursa, de obicei cu majuscule (un cod poștal care nu are șase cifre este dat mai sus ca null, aici cum este). În câmpurile de mai sus sunt scrise pentru cititor: se schimbă doar literele mari și mici, spațiile, punctuația, ş și ţ (scrise cu virgulă dedesubt) și forma câtorva prescurtări (STR devine Str., NR. devine nr.); niciun cuvânt și niciun număr nu lipsește și nu își schimbă locul. Forma juridică rămâne cum a fost înregistrată (SRL sau S.R.L.). |
FiscalObligations
| Câmp | Tip | Descriere |
|---|---|---|
la_data | dată | Ziua listei: ziua până la care ministerul prelucrase declarațiile cuprinse în ea. Lista se publică o dată pe an, iar tot ce este aici este starea din această zi. |
regim_impozitare | text sau nimic | Cum era impozitat venitul, după obligațiile din listă: profit (impozit pe profit, codul 100), micro (impozit pe veniturile microîntreprinderilor, 120) sau specific (impozit specific, 130); null când lista nu are niciuna dintre ele sau are mai multe. |
obligatii | listă | Obligațiile la care era înregistrat, fiecare cu cod (codul ministerului: 100 impozit pe profit, 120 impozit pe veniturile microîntreprinderilor, 200 accize, 602 impozit pe salarii, 480 contribuția asiguratorie pentru muncă, ...) și denumire. O listă goală înseamnă că ministerul avea contribuabilul în listă, fără vreo obligație. |
ultima_declaratie | dată sau nimic | Ziua în care a fost înregistrată ultima declarație a contribuabilului, cum o dă lista („data înregistrării ultimei declarații”). Nu este data înregistrării fiscale și nici a ultimei declarații de impozite (firmele cu salariați depun lunar, iar la cele mai multe data este mai veche de un an): după toate semnele, este ultima declarație privitoare la înregistrarea fiscală, de pildă o schimbare a obligațiilor. |
ultima_prelucrare | dată sau nimic | Ziua în care ministerul a prelucrat ultima oară datele contribuabilului, cum o dă lista („data ultimei prelucrări”). |
Source
| Câmp | Tip | Descriere |
|---|---|---|
source | text | Cheia sursei: anaf_ws, onrc_bulk, mf_financials, anaf_bilant, mf_vector_fiscal. |
name | text | Denumirea sursei. |
publisher | text | Instituția care publică datele. |
licence | text sau nimic | Licența sub care sunt publicate datele, unde este declarată. |
dataset | text sau nimic | Setul de date din care a fost luată ultima oară informația, pentru sursele care publică fișiere. |
dataset_url | text sau nimic | Pagina setului de date (la situațiile financiare). |
published_at | moment sau nimic | Când a publicat instituția fișierul (la situațiile financiare); null la cele luate din serviciul web al ANAF, care nu spune când le-a publicat. |
first_retrieved_on | dată sau nimic | Ziua în care sursa a furnizat prima oară informația. |
last_retrieved_on | dată sau nimic | Ziua în care a furnizat-o ultima oară. |
import_run_id | număr întreg sau nimic | Rularea de import care a adus informația. |
Event
| Câmp | Tip | Descriere |
|---|---|---|
type | text | Felul schimbării: vat_registered, vat_deregistered, vat_on_collection_started, vat_on_collection_ended, split_vat_started, split_vat_ended, inactivated, reactivated, efactura_registered, efactura_deregistered, struck_off, status_changed, name_changed, address_changed, caen_changed. |
old | obiect sau nimic | Valoarea dinainte, sub numele câmpului schimbat (denumire, adresa_completa, stare, caen); null când evenimentul este un început sau un sfârșit. O denumire sau o adresă este scrisă pentru cititor, ca la datele firmei. |
new | obiect sau nimic | Valoarea de după, la fel. |
occurred_on | dată sau nimic | Ziua pe care sursa o dă pentru schimbare, acolo unde o dă (de exemplu începutul perioadei de TVA). |
detected_on | dată | Ziua în care am observat schimbarea. |
source | text | Cheia sursei în al cărei răspuns a apărut schimbarea: anaf_ws. |
oficial | obiect sau nimic | La o schimbare de denumire sau de adresă, valoarea dinainte (old) și cea de după (new) așa cum le scrie sursa; null la celelalte. |
Statement
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg | CUI-ul firmei. |
an | număr întreg | Anul situației financiare. |
tip_raportare | text | Tipul de raportare al Ministerului Finanțelor: UU (bilanț prescurtat), BL_BS_SL, IR (IFRS), ONG, ... Serviciul web al ANAF nu dă tipul: la o situație luată de acolo este dedus din indicatorii ei, iar unde mai multe tipuri au aceiași indicatori este tipul firmei din anul dinainte. |
tip_raportare_descriere | text sau nimic | Ce fel de contribuabili depun acest tip. |
caen | număr întreg sau nimic | Codul CAEN din situația financiară. |
caen_denumire | text sau nimic | Denumirea codului, în clasificarea în vigoare în acel an. |
active_imobilizate | număr întreg sau nimic | Active imobilizate, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
active_circulante | număr întreg sau nimic | Active circulante, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
stocuri | număr întreg sau nimic | Stocuri. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
creante | număr întreg sau nimic | Creanțe. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
casa_banca | număr întreg sau nimic | Casa și conturi la bănci. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
cheltuieli_avans | număr întreg sau nimic | Cheltuieli în avans. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
datorii | număr întreg sau nimic | Datorii. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
venituri_avans | număr întreg sau nimic | Venituri în avans. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
provizioane | număr întreg sau nimic | Provizioane. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
capitaluri_total | număr întreg sau nimic | Capitaluri, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
capital_social | număr întreg sau nimic | Capital subscris vărsat. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
patrimoniul_regiei | număr întreg sau nimic | Patrimoniul regiei. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
cifra_afaceri | număr întreg sau nimic | Cifra de afaceri netă. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
venituri_totale | număr întreg sau nimic | Venituri totale. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
cheltuieli_totale | număr întreg sau nimic | Cheltuieli totale. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
profit_brut | număr întreg sau nimic | Profit brut. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
pierdere_bruta | număr întreg sau nimic | Pierdere brută. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
profit_net | număr întreg sau nimic | Profit net. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
pierdere_neta | număr întreg sau nimic | Pierdere netă. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
nr_mediu_salariati | număr întreg sau nimic | Număr mediu de salariați. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF). |
alti_indicatori | listă | Indicatorii pe care acest tip de raportare îi are în plus, fiecare cu cod, denumire și valoare. |
updated_at | moment | Când s-a schimbat ultima oară situația în baza noastră de date. |
sources | listă de Source | De unde provine situația (setul de date al ministerului și când l-a publicat, sau serviciul web al ANAF) și când am preluat-o. |
Registration
| Câmp | Tip | Descriere |
|---|---|---|
cui | număr întreg | Codul unic de identificare. |
denumire | text sau nimic | Denumirea, scrisă pentru cititor; cum o scrie sursa este în oficial. |
nr_reg_com | text sau nimic | Numărul de înregistrare în registrul comerțului. |
adresa_completa | text sau nimic | Adresa firmei, într-un singur text, scrisă pentru cititor: domiciliul fiscal, cum îl dă ANAF, iar la o firmă despre care ANAF nu a răspuns, sediul din registrul comerțului. Unde ANAF are domiciliul fiscal în altă parte decât sediul social, județul, localitatea și codul poștal sunt tot ale lui; sediul social este în sediu_social. Cum o scrie sursa este în oficial. |
localitate | text sau nimic | Localitatea adresei firmei, scrisă pentru cititor; cum o scrie sursa este în oficial. |
judet | text sau nimic | Codul județului adresei firmei: SB, B, ... Filtrele după județ (firmele noi, căutarea, webhooks) merg după județul sediului social (sediu_social.judet), care este același la aproape toate firmele. |
cod_postal | text sau nimic | Codul poștal al adresei firmei, din șase cifre. null unde sursa nu are unul în uz (codurile de dinainte de 2003, valori incomplete). |
stare | text sau nimic | Starea, într-un cuvânt: FUNCTIUNE, SUSPENDARE, REORGANIZARE JUDICIARA, INSOLVENTA, DIZOLVARE, LICHIDARE, FALIMENT, RADIERE. |
stare_detalii | text sau nimic | Starea înregistrării la ANAF, cu ziua ei, scrisă pentru cititor: „Dizolvare fără lichidare (fuziune) din data 01.06.2024”, „Suspendare activitate din data 01.03.2025”, „Înregistrat din data 23.11.2000”. Spune mai mult decât stare (de pildă că firma a fost absorbită la o fuziune); cum o scrie ANAF este în oficial.stare_detalii. null unde ANAF nu dă nimic. |
persoana_fizica | da/nu sau nimic | false pentru o persoană juridică, true pentru o persoană fizică care desfășoară o activitate economică (PFA, întreprindere individuală sau familială, profesie liberală), null cât timp sursele nu permit să se spună. |
forma_juridica_cod | text sau nimic | Forma juridică din registrul comerțului: SRL, SA, ... |
forma_juridica | text sau nimic | Forma juridică așa cum o scrie ANAF. |
caen | număr întreg sau nimic | Codul CAEN al activității principale (sursa: ANAF). |
caen_denumire | text sau nimic | Denumirea codului CAEN, în clasificarea în vigoare. |
scp_tva | da/nu | Dacă este înregistrată în scopuri de TVA. |
data_inceput_tva | dată sau nimic | De când este înregistrată în scopuri de TVA. |
data_sfarsit_tva | dată sau nimic | Până când a fost înregistrată, dacă nu mai este. |
tva_incasare | da/nu | Dacă aplică TVA la încasare. |
split_tva | da/nu | Dacă aplică plata defalcată a TVA. |
e_factura | da/nu | Dacă este înscrisă în registrul RO e-Factura. |
status_inactiv | da/nu | Dacă este declarată inactivă fiscal. |
data_inactivare | dată sau nimic | De când este inactivă. |
data_inregistrare | dată sau nimic | Data înregistrării fiscale (sursa: ANAF). |
data_inmatriculare | dată sau nimic | Data intrării în registrul comerțului (sursa: ONRC). |
registered_on | dată sau nimic | Data înregistrării: intrarea în registrul comerțului unde este cunoscută, altfel înregistrarea fiscală la ANAF. |
telefon | text sau nimic | Telefonul declarat la ANAF, cum îl scrie ANAF. null și unde ANAF nu are decât o valoare fără nicio cifră în afară de 0 („0”, „0/0”, „nedeclarat”). |
fax | text sau nimic | Faxul declarat la ANAF, cum îl scrie ANAF. null și unde ANAF nu are decât o valoare fără nicio cifră în afară de 0 („0”, „0/0”, „nedeclarat”). |
web | text sau nimic | Adresa web declarată la registrul comerțului. |
euid | text sau nimic | Identificatorul unic european (sursa: ONRC). |
sediu_secundar | da/nu | Dacă este sediul secundar al unei firme, înregistrat la ANAF cu CUI propriu. |
updated_on | dată sau nimic | Ziua în care s-a schimbat ultima oară ceva în datele firmei. |
changed_on | dată sau nimic | Ziua în care s-a schimbat ultima oară o valoare deja cunoscută a firmei; null dacă nu s-a schimbat nimic de când o avem. Se urmărește tot ce dau sursele: orice câmp al răspunsului ANAF (denumirea, adresele, telefonul, faxul, codul poștal, starea, codul CAEN, TVA, TVA la încasare, plata defalcată, inactivitatea, e-Factura), datele din registrul comerțului și obligațiile fiscale. Nu este o schimbare o informație care lipsea și a fost completată, nici una scrisă doar altfel (litere mari, spații, ş sau ș). |
checked_on | dată sau nimic | Ziua în care a fost întrebat ultima oară ANAF despre firmă; null dacă încă nu. |
sediu_social | obiect | Sediul social, cum îl dau ANAF și registrul comerțului: judet, localitate, strada, numar, detalii și cod_postal, scrise pentru cititor (cum le scrie sursa sunt în oficial.sediu_social). La aproape toate firmele este aceeași adresă cu cea de mai sus; diferă unde domiciliul fiscal declarat la ANAF este în altă parte. |
obligatii_fiscale | FiscalObligations sau nimic | Obligațiile fiscale la care contribuabilul era înregistrat (vectorul fiscal), din lista pe care Ministerul Finanțelor o publică o dată pe an: starea din ziua listei (la_data), nu cea de azi. null când nu se cunosc: firma nu apare în listă sau a fost preluată după ce lista a fost importată. Nu înseamnă că nu are obligații. |
stari_registru | listă | Toate stările și mențiunile din registrul comerțului, fiecare cu cod și denumire. |
caen_autorizate | listă sau nimic | Activitățile pentru care firma este autorizată, din datele deschise ale registrului comerțului: fiecare cu cod, versiune (a clasificării CAEN în care a fost declarată: 3 este cea din 2025, 2 cea din 2008, 1 cea din 2003, 0 cea din 1998) și denumire, cea mai nouă clasificare întâi. Registrul păstrează și ce a fost declarat în clasificările vechi, deci aceeași activitate poate apărea cu coduri din mai multe versiuni. null când nu sunt cunoscute (firma nu este în setul registrului), ceea ce nu înseamnă că nu are niciuna. |
sources | listă de Source | Din ce surse vin datele firmei și de când. |
oficial | obiect | Denumirea (denumire), localitatea (localitate), adresa (adresa_completa), codul poștal (cod_postal), starea la ANAF (stare_detalii) și, din sediul social, localitatea, strada, detaliile și codul poștal (sediu_social) așa cum le scrie sursa, de obicei cu majuscule (un cod poștal care nu are șase cifre este dat mai sus ca null, aici cum este). În câmpurile de mai sus sunt scrise pentru cititor: se schimbă doar literele mari și mici, spațiile, punctuația, ş și ţ (scrise cu virgulă dedesubt) și forma câtorva prescurtări (STR devine Str., NR. devine nr.); niciun cuvânt și niciun număr nu lipsește și nu își schimbă locul. Forma juridică rămâne cum a fost înregistrată (SRL sau S.R.L.). |
RegistrationEvent
| Câmp | Tip | Descriere |
|---|---|---|
id | text | Identifică evenimentul: company.registered: urmat de CUI. Același la fiecare reîncercare. |
type | text | Felul evenimentului: company.registered. |
test | da/nu | true pentru un mesaj de probă cerut din cont: are forma unuia adevărat, cu o firmă oarecare, și un id care începe cu test:. |
created_at | moment | Când a fost creat evenimentul. |
data | Registration | Firma, exact cum o întoarce GET /rest/v1/registrations. |
Problem
| Câmp | Tip | Descriere |
|---|---|---|
type | text | Adresa care identifică felul erorii. |
title | text | Eroarea, pe scurt. |
status | număr întreg | Codul HTTP. |
detail | text | Ce anume nu a mers. |