Documentația API

Cuprins

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.

ParametruUndeDescriere
cuiîn cale, obligatoriuCodul 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:

CodCe înseamnă
200Firma.
202Firma 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.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
404Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request).
429Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere.
503Firma 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âmpTipDescriere
cuinumăr întregCodul unic de identificare.
denumiretext sau nimicDenumirea, scrisă pentru cititor; cum o scrie sursa este în oficial.
nr_reg_comtext sau nimicNumărul de înregistrare în registrul comerțului.
adresa_completatext sau nimicAdresa 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.
localitatetext sau nimicLocalitatea adresei firmei, scrisă pentru cititor; cum o scrie sursa este în oficial.
judettext sau nimicCodul 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_postaltext sau nimicCodul poștal al adresei firmei, din șase cifre. null unde sursa nu are unul în uz (codurile de dinainte de 2003, valori incomplete).
staretext sau nimicStarea, într-un cuvânt: FUNCTIUNE, SUSPENDARE, REORGANIZARE JUDICIARA, INSOLVENTA, DIZOLVARE, LICHIDARE, FALIMENT, RADIERE.
stare_detaliitext sau nimicStarea î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_fizicada/nu sau nimicfalse 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_codtext sau nimicForma juridică din registrul comerțului: SRL, SA, ...
forma_juridicatext sau nimicForma juridică așa cum o scrie ANAF.
caennumăr întreg sau nimicCodul CAEN al activității principale (sursa: ANAF).
caen_denumiretext sau nimicDenumirea codului CAEN, în clasificarea în vigoare.
scp_tvada/nuDacă este înregistrată în scopuri de TVA.
data_inceput_tvadată sau nimicDe când este înregistrată în scopuri de TVA.
data_sfarsit_tvadată sau nimicPână când a fost înregistrată, dacă nu mai este.
tva_incasareda/nuDacă aplică TVA la încasare.
split_tvada/nuDacă aplică plata defalcată a TVA.
e_facturada/nuDacă este înscrisă în registrul RO e-Factura.
status_inactivda/nuDacă este declarată inactivă fiscal.
data_inactivaredată sau nimicDe când este inactivă.
data_inregistraredată sau nimicData înregistrării fiscale (sursa: ANAF).
data_inmatricularedată sau nimicData intrării în registrul comerțului (sursa: ONRC).
telefontext sau nimicTelefonul 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”).
faxtext sau nimicFaxul 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”).
webtext sau nimicAdresa web declarată la registrul comerțului.
euidtext sau nimicIdentificatorul unic european (sursa: ONRC).
sediu_secundarda/nuDacă este sediul secundar al unei firme, înregistrat la ANAF cu CUI propriu.
updated_ondată sau nimicZiua în care s-a schimbat ultima oară ceva în datele firmei.
changed_ondată sau nimicZiua î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_ondată sau nimicZiua în care a fost întrebat ultima oară ANAF despre firmă; null dacă încă nu.
sediu_socialobiectSediul 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_fiscaleFiscalObligations sau nimicObligaț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_registrulistăToate stările și mențiunile din registrul comerțului, fiecare cu cod și denumire.
caen_autorizatelistă sau nimicActivităț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.
sourceslistă de SourceDin ce surse vin datele firmei și de când.
oficialobiectDenumirea (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âmpTipDescriere
cuislistăÎ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:

CodCe înseamnă
200Firmele găsite și ce este cu celelalte CUI-uri.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
429Limita 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âmpTipDescriere
datalistă de CompanyFirmele găsite, în ordinea în care au fost cerute.
not_storedlistăCUI-urile valide care nu sunt încă în baza de date. Nu costă nimic; cerute singure, sunt căutate la ANAF.
incompletelistă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.
invalidlistăCe nu este un CUI valid, așa cum a fost primit.

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.

ParametruUndeDescriere
denumireîn interogareDenumirea 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 interogareNumă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 interogareDoar î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:

CodCe înseamnă
200Firmele găsite.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
429Limita 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âmpTipDescriere
datalistă de CompanyFoundFirmele găsite, cele mai apropiate întâi: cel mult 10.
moreda/nutrue 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.

ParametruUndeDescriere
cuiîn cale, obligatoriuCodul 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:

CodCe înseamnă
200Schimbările observate la firmă.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
404Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request).
429Limita 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âmpTipDescriere
cuinumăr întregCUI-ul firmei.
eventslistă de EventSchimbă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).

ParametruUndeDescriere
cuiîn cale, obligatoriuCodul 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:

CodCe înseamnă
200Rezultatul verificării.
202Firma 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.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
404Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request).
429Limita pe minut sau numărul de cereri al lunii a fost depășit. Nu se numără ca cerere.
503Firma 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âmpTipDescriere
cuinumăr întregCodul unic de identificare.
denumiretext sau nimicDenumirea, scrisă pentru cititor; cum o scrie sursa este în oficial.
existsda/nuDacă ANAF cunoaște un contribuabil cu acest CUI.
valid_for_invoicingda/nuDacă firma există, nu este radiată și nu este inactivă fiscal.
vat_registeredda/nuDacă este înregistrată în scopuri de TVA.
vat_numbertext sau nimicCodul de TVA (RO urmat de CUI), dacă este înregistrată în scopuri de TVA.
vat_on_collectionda/nuDacă aplică TVA la încasare.
split_vatda/nuDacă aplică plata defalcată a TVA.
inactiveda/nuDacă este declarată inactivă fiscal.
struck_offda/nuDacă este radiată.
efactura_registeredda/nuDacă este înscrisă în registrul RO e-Factura.
staretext sau nimicStarea, într-un cuvânt, ca la datele firmei.
checked_ondată sau nimicZiua în care a răspuns ANAF ultima oară despre firmă.
oficialobiect sau nimicDenumirea (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.

ParametruUndeDescriere
cuiîn cale, obligatoriuCodul 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:

CodCe înseamnă
200Situațiile financiare ale firmei.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
404Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request).
429Limita 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âmpTipDescriere
cuinumăr întregCUI-ul firmei.
financialslistă de StatementSituațiile financiare, cel mai recent an întâi.

GET /rest/v1/companies/{cui}/financials/{year}

Situația financiară dintr-un an.

ParametruUndeDescriere
cuiîn cale, obligatoriuCodul unic de identificare, cu sau fără prefixul RO, de exemplu 13548146.
yearîn cale, obligatoriuAnul situației financiare, de exemplu 2025.
curl https://api.apifirme.dev/rest/v1/companies/13548146/financials/2025 \
  -H "Authorization: Bearer af_live_..."

Răspunsuri:

CodCe înseamnă
200Situația financiară a anului.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
404Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request).
429Limita 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âmpTipDescriere
cuinumăr întregCUI-ul firmei.
annumăr întregAnul situației financiare.
tip_raportaretextTipul 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_descrieretext sau nimicCe fel de contribuabili depun acest tip.
caennumăr întreg sau nimicCodul CAEN din situația financiară.
caen_denumiretext sau nimicDenumirea codului, în clasificarea în vigoare în acel an.
active_imobilizatenumăr întreg sau nimicActive imobilizate, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
active_circulantenumăr întreg sau nimicActive circulante, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
stocurinumăr întreg sau nimicStocuri. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
creantenumăr întreg sau nimicCreanțe. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
casa_bancanumăr întreg sau nimicCasa ș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_avansnumăr întreg sau nimicCheltuieli în avans. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
datoriinumăr întreg sau nimicDatorii. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
venituri_avansnumăr întreg sau nimicVenituri în avans. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
provizioanenumăr întreg sau nimicProvizioane. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
capitaluri_totalnumăr întreg sau nimicCapitaluri, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
capital_socialnumăr întreg sau nimicCapital subscris vărsat. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
patrimoniul_regieinumăr întreg sau nimicPatrimoniul regiei. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
cifra_afacerinumăr întreg sau nimicCifra de afaceri netă. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
venituri_totalenumăr întreg sau nimicVenituri totale. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
cheltuieli_totalenumăr întreg sau nimicCheltuieli totale. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
profit_brutnumăr întreg sau nimicProfit brut. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
pierdere_brutanumăr întreg sau nimicPierdere brută. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
profit_netnumăr întreg sau nimicProfit net. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
pierdere_netanumăr întreg sau nimicPierdere netă. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
nr_mediu_salariatinumăr întreg sau nimicNumă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_indicatorilistăIndicatorii pe care acest tip de raportare îi are în plus, fiecare cu cod, denumire și valoare.
updated_atmomentCând s-a schimbat ultima oară situația în baza noastră de date.
sourceslistă de SourceDe 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.

ParametruUndeDescriere
daysîn interogareFirmele înregistrate în ultimele atâtea zile. Nu împreună cu registered_after.
registered_afterîn interogareFirmele înregistrate începând cu această zi.
caenîn interogareUnul sau mai multe coduri CAEN de patru cifre, despărțite prin virgulă.
caen_prefixîn interogarePrimele două cifre (diviziunea) sau trei (grupa) ale codului CAEN.
judetîn interogareUnul sau mai multe coduri de județ (SB, B), despărțite prin virgulă: județul sediului social.
forma_juridicaîn interogareUna sau mai multe forme juridice, cu codurile registrului comerțului (SRL, SA), despărțite prin virgulă.
persoana_fizicaîn interogaretrue 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 interogareCâte firme pe pagină, între 1 și 500. Implicit 100.
cursorîn interogareValoarea 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:

CodCe înseamnă
200O pagină de firme noi.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
429Limita 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âmpTipDescriere
datalistă de RegistrationFirmele, în ordinea în care au fost indexate.
next_cursortextDe trimis ca cursor pentru pagina următoare. Este și pe ultima pagină: păstrat și trimis a doua zi, aduce firmele indexate între timp.
moreda/nuDacă după această pagină mai sunt firme.
filterobiectFiltrul 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.

ParametruUndeDescriere
daysîn interogareFirmele înregistrate în ultimele atâtea zile. Nu împreună cu registered_after.
registered_afterîn interogareFirmele înregistrate începând cu această zi.
caenîn interogareUnul sau mai multe coduri CAEN de patru cifre, despărțite prin virgulă.
caen_prefixîn interogarePrimele două cifre (diviziunea) sau trei (grupa) ale codului CAEN.
judetîn interogareUnul sau mai multe coduri de județ (SB, B), despărțite prin virgulă: județul sediului social.
forma_juridicaîn interogareUna sau mai multe forme juridice, cu codurile registrului comerțului (SRL, SA), despărțite prin virgulă.
persoana_fizicaîn interogaretrue 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:

CodCe înseamnă
200Numărul de firme.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
429Limita 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âmpTipDescriere
countnumăr întregNumărul firmelor care corespund filtrului.
filterobiectFiltrul aplicat, cu perioada rezultată.
upgrade_required_for_recordsda/nuDacă 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:

CodCe înseamnă
200Cursurile din ultima zi bancară.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
404Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request).
429Limita 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âmpTipDescriere
datedatăZiua cerută.
effective_datedatăZiua bancară pentru care a fost publicat cursul.
basetextMoneda în care sunt exprimate cursurile: RON.
ratesobiectPentru fiecare valută: rate, în lei pentru multiplier unități ale valutei.
sourceobiectSursa 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.

ParametruUndeDescriere
dateîn cale, obligatoriuZiua, de exemplu 2026-10-02.
curl https://api.apifirme.dev/rest/v1/fx/2026-10-02 \
  -H "Authorization: Bearer af_live_..."

Răspunsuri:

CodCe înseamnă
200Cursurile valabile în acea zi.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
404Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request).
429Limita 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âmpTipDescriere
datedatăZiua cerută.
effective_datedatăZiua bancară pentru care a fost publicat cursul.
basetextMoneda în care sunt exprimate cursurile: RON.
ratesobiectPentru fiecare valută: rate, în lei pentru multiplier unități ale valutei.
sourceobiectSursa cursului și când a fost preluat.

GET /rest/v1/fx/series

Cursul unei valute pe o perioadă.

ParametruUndeDescriere
currencyîn interogare, obligatoriuCodul valutei, de exemplu EUR.
fromîn interogare, obligatoriuPrima zi.
toîn interogare, obligatoriuUltima 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:

CodCe înseamnă
200Cursul din fiecare zi bancară a perioadei.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
429Limita 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âmpTipDescriere
currencytextValuta.
basetextRON.
fromdatăPrima zi a perioadei.
todatăUltima zi a perioadei.
serieslistăPentru fiecare zi bancară: date, rate și multiplier.

GET /rest/v1/fx/convert

Conversie între două valute.

ParametruUndeDescriere
fromîn interogare, obligatoriuValuta sumei, de exemplu EUR.
toîn interogare, obligatoriuValuta rezultatului, de exemplu RON.
amountîn interogare, obligatoriuSuma.
dateîn interogareZiua 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:

CodCe înseamnă
200Suma convertită la cursul BNR.
400Un 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.
401Cheia API lipsește sau nu este validă.
403Planul 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ă).
404Nu există: CUI neînregistrat, nicio dată pentru ziua ori anul cerut, sau un CUI despre care nu oferim date (withheld-on-request).
429Limita 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âmpTipDescriere
fromtextValuta sumei.
totextValuta rezultatului.
amountnumărSuma.
resultnumărSuma convertită.
ratenumărCursul folosit, din from în to.
datedatăZiua cerută.
effective_datedată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.

ParametruUndeDescriere
cuiîn cale, obligatoriuCodul unic de identificare, cu sau fără prefixul RO, de exemplu 13548146.
curl https://api.apifirme.dev/rest/v1/validate/cui/13548146

Răspunsuri:

CodCe înseamnă
200Rezultatul verificării.

Răspunsul 200 este un obiect CuiValidation:

CâmpTipDescriere
cuinumăr întreg sau textCUI-ul ca număr, dacă este valid; altfel textul primit.
validda/nuDacă 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âmpTipDescriere
cuinumăr întregCodul unic de identificare.
denumiretext sau nimicDenumirea, scrisă pentru cititor; cum o scrie sursa este în oficial.
nr_reg_comtext sau nimicNumărul de înregistrare în registrul comerțului.
adresa_completatext sau nimicAdresa 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.
localitatetext sau nimicLocalitatea adresei firmei, scrisă pentru cititor; cum o scrie sursa este în oficial.
judettext sau nimicCodul 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_postaltext sau nimicCodul poștal al adresei firmei, din șase cifre. null unde sursa nu are unul în uz (codurile de dinainte de 2003, valori incomplete).
staretext sau nimicStarea, într-un cuvânt: FUNCTIUNE, SUSPENDARE, REORGANIZARE JUDICIARA, INSOLVENTA, DIZOLVARE, LICHIDARE, FALIMENT, RADIERE.
stare_detaliitext sau nimicStarea î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_fizicada/nu sau nimicfalse 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_codtext sau nimicForma juridică din registrul comerțului: SRL, SA, ...
forma_juridicatext sau nimicForma juridică așa cum o scrie ANAF.
caennumăr întreg sau nimicCodul CAEN al activității principale (sursa: ANAF).
caen_denumiretext sau nimicDenumirea codului CAEN, în clasificarea în vigoare.
scp_tvada/nuDacă este înregistrată în scopuri de TVA.
data_inceput_tvadată sau nimicDe când este înregistrată în scopuri de TVA.
data_sfarsit_tvadată sau nimicPână când a fost înregistrată, dacă nu mai este.
tva_incasareda/nuDacă aplică TVA la încasare.
split_tvada/nuDacă aplică plata defalcată a TVA.
e_facturada/nuDacă este înscrisă în registrul RO e-Factura.
status_inactivda/nuDacă este declarată inactivă fiscal.
data_inactivaredată sau nimicDe când este inactivă.
data_inregistraredată sau nimicData înregistrării fiscale (sursa: ANAF).
data_inmatricularedată sau nimicData intrării în registrul comerțului (sursa: ONRC).
telefontext sau nimicTelefonul 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”).
faxtext sau nimicFaxul 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”).
webtext sau nimicAdresa web declarată la registrul comerțului.
euidtext sau nimicIdentificatorul unic european (sursa: ONRC).
sediu_secundarda/nuDacă este sediul secundar al unei firme, înregistrat la ANAF cu CUI propriu.
updated_ondată sau nimicZiua în care s-a schimbat ultima oară ceva în datele firmei.
changed_ondată sau nimicZiua î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_ondată sau nimicZiua în care a fost întrebat ultima oară ANAF despre firmă; null dacă încă nu.
sediu_socialobiectSediul 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_fiscaleFiscalObligations sau nimicObligaț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_registrulistăToate stările și mențiunile din registrul comerțului, fiecare cu cod și denumire.
caen_autorizatelistă sau nimicActivităț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.
sourceslistă de SourceDin ce surse vin datele firmei și de când.
oficialobiectDenumirea (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âmpTipDescriere
la_datadată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_impozitaretext sau nimicCum 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.
obligatiilistă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_declaratiedată sau nimicZiua î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_prelucraredată sau nimicZiua în care ministerul a prelucrat ultima oară datele contribuabilului, cum o dă lista („data ultimei prelucrări”).

Source

CâmpTipDescriere
sourcetextCheia sursei: anaf_ws, onrc_bulk, mf_financials, anaf_bilant, mf_vector_fiscal.
nametextDenumirea sursei.
publishertextInstituția care publică datele.
licencetext sau nimicLicența sub care sunt publicate datele, unde este declarată.
datasettext sau nimicSetul de date din care a fost luată ultima oară informația, pentru sursele care publică fișiere.
dataset_urltext sau nimicPagina setului de date (la situațiile financiare).
published_atmoment sau nimicCâ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_ondată sau nimicZiua în care sursa a furnizat prima oară informația.
last_retrieved_ondată sau nimicZiua în care a furnizat-o ultima oară.
import_run_idnumăr întreg sau nimicRularea de import care a adus informația.

Event

CâmpTipDescriere
typetextFelul 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.
oldobiect sau nimicValoarea 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.
newobiect sau nimicValoarea de după, la fel.
occurred_ondată sau nimicZiua pe care sursa o dă pentru schimbare, acolo unde o dă (de exemplu începutul perioadei de TVA).
detected_ondatăZiua în care am observat schimbarea.
sourcetextCheia sursei în al cărei răspuns a apărut schimbarea: anaf_ws.
oficialobiect sau nimicLa 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âmpTipDescriere
cuinumăr întregCUI-ul firmei.
annumăr întregAnul situației financiare.
tip_raportaretextTipul 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_descrieretext sau nimicCe fel de contribuabili depun acest tip.
caennumăr întreg sau nimicCodul CAEN din situația financiară.
caen_denumiretext sau nimicDenumirea codului, în clasificarea în vigoare în acel an.
active_imobilizatenumăr întreg sau nimicActive imobilizate, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
active_circulantenumăr întreg sau nimicActive circulante, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
stocurinumăr întreg sau nimicStocuri. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
creantenumăr întreg sau nimicCreanțe. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
casa_bancanumăr întreg sau nimicCasa ș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_avansnumăr întreg sau nimicCheltuieli în avans. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
datoriinumăr întreg sau nimicDatorii. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
venituri_avansnumăr întreg sau nimicVenituri în avans. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
provizioanenumăr întreg sau nimicProvizioane. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
capitaluri_totalnumăr întreg sau nimicCapitaluri, total. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
capital_socialnumăr întreg sau nimicCapital subscris vărsat. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
patrimoniul_regieinumăr întreg sau nimicPatrimoniul regiei. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
cifra_afacerinumăr întreg sau nimicCifra de afaceri netă. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
venituri_totalenumăr întreg sau nimicVenituri totale. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
cheltuieli_totalenumăr întreg sau nimicCheltuieli totale. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
profit_brutnumăr întreg sau nimicProfit brut. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
pierdere_brutanumăr întreg sau nimicPierdere brută. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
profit_netnumăr întreg sau nimicProfit net. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
pierdere_netanumăr întreg sau nimicPierdere netă. În lei întregi; null dacă ministerul nu publică valoarea (zero în situațiile luate din serviciul web al ANAF).
nr_mediu_salariatinumăr întreg sau nimicNumă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_indicatorilistăIndicatorii pe care acest tip de raportare îi are în plus, fiecare cu cod, denumire și valoare.
updated_atmomentCând s-a schimbat ultima oară situația în baza noastră de date.
sourceslistă de SourceDe 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âmpTipDescriere
cuinumăr întregCodul unic de identificare.
denumiretext sau nimicDenumirea, scrisă pentru cititor; cum o scrie sursa este în oficial.
nr_reg_comtext sau nimicNumărul de înregistrare în registrul comerțului.
adresa_completatext sau nimicAdresa 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.
localitatetext sau nimicLocalitatea adresei firmei, scrisă pentru cititor; cum o scrie sursa este în oficial.
judettext sau nimicCodul 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_postaltext sau nimicCodul poștal al adresei firmei, din șase cifre. null unde sursa nu are unul în uz (codurile de dinainte de 2003, valori incomplete).
staretext sau nimicStarea, într-un cuvânt: FUNCTIUNE, SUSPENDARE, REORGANIZARE JUDICIARA, INSOLVENTA, DIZOLVARE, LICHIDARE, FALIMENT, RADIERE.
stare_detaliitext sau nimicStarea î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_fizicada/nu sau nimicfalse 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_codtext sau nimicForma juridică din registrul comerțului: SRL, SA, ...
forma_juridicatext sau nimicForma juridică așa cum o scrie ANAF.
caennumăr întreg sau nimicCodul CAEN al activității principale (sursa: ANAF).
caen_denumiretext sau nimicDenumirea codului CAEN, în clasificarea în vigoare.
scp_tvada/nuDacă este înregistrată în scopuri de TVA.
data_inceput_tvadată sau nimicDe când este înregistrată în scopuri de TVA.
data_sfarsit_tvadată sau nimicPână când a fost înregistrată, dacă nu mai este.
tva_incasareda/nuDacă aplică TVA la încasare.
split_tvada/nuDacă aplică plata defalcată a TVA.
e_facturada/nuDacă este înscrisă în registrul RO e-Factura.
status_inactivda/nuDacă este declarată inactivă fiscal.
data_inactivaredată sau nimicDe când este inactivă.
data_inregistraredată sau nimicData înregistrării fiscale (sursa: ANAF).
data_inmatricularedată sau nimicData intrării în registrul comerțului (sursa: ONRC).
registered_ondată sau nimicData înregistrării: intrarea în registrul comerțului unde este cunoscută, altfel înregistrarea fiscală la ANAF.
telefontext sau nimicTelefonul 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”).
faxtext sau nimicFaxul 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”).
webtext sau nimicAdresa web declarată la registrul comerțului.
euidtext sau nimicIdentificatorul unic european (sursa: ONRC).
sediu_secundarda/nuDacă este sediul secundar al unei firme, înregistrat la ANAF cu CUI propriu.
updated_ondată sau nimicZiua în care s-a schimbat ultima oară ceva în datele firmei.
changed_ondată sau nimicZiua î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_ondată sau nimicZiua în care a fost întrebat ultima oară ANAF despre firmă; null dacă încă nu.
sediu_socialobiectSediul 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_fiscaleFiscalObligations sau nimicObligaț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_registrulistăToate stările și mențiunile din registrul comerțului, fiecare cu cod și denumire.
caen_autorizatelistă sau nimicActivităț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.
sourceslistă de SourceDin ce surse vin datele firmei și de când.
oficialobiectDenumirea (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âmpTipDescriere
idtextIdentifică evenimentul: company.registered: urmat de CUI. Același la fiecare reîncercare.
typetextFelul evenimentului: company.registered.
testda/nutrue 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_atmomentCând a fost creat evenimentul.
dataRegistrationFirma, exact cum o întoarce GET /rest/v1/registrations.

Problem

CâmpTipDescriere
typetextAdresa care identifică felul erorii.
titletextEroarea, pe scurt.
statusnumăr întregCodul HTTP.
detailtextCe anume nu a mers.