API bilanț firmă după CUI

Obții până la 5 ani de situații financiare (bilanț) pentru o firmă din România, în RON: cifra de afaceri, veniturile și cheltuielile, profitul, numărul mediu de angajați, posturile principale din bilanț și indicatori calculați. Separat, starea din Registrul Comerțului, codurile CAEN și reprezentanții legali. Pentru analiză de credit, scoring de clienți și rapoarte.

Cheie gratuită (100 credite)Documentație

Exemplu curl

curl -H "x-api-key: $HTR_KEY" "https://api.howtoromania.io/v1/company/14399840/financials?years=3"
curl -H "x-api-key: $HTR_KEY" "https://api.howtoromania.io/v1/company/14399840/representatives"

Cheie gratuită: curl -X POST https://api.howtoromania.io/v1/keys -H "content-type: application/json" -d '{"email":"you@example.com","accept_terms":true}'

Exemplu MCP

{ "mcpServers": { "howtoromania": { "url": "https://api.howtoromania.io/mcp", "headers": { "Authorization": "Bearer htr_demo" } } } }

Cere agentului: “Arată cifra de afaceri, profitul net și numărul de angajați pentru CUI 14399840 în ultimii 3 ani, cu creșterea de la an la an.”

Ce primești pentru fiecare an

  • Contul de profit și pierdere: netTurnover (cifra de afaceri netă), totalRevenue, totalExpenses, grossProfit, netProfit
  • Bilanț: fixedAssets, currentAssets, inventories, receivables, cash, prepaidExpenses, totalAssets, debts, deferredIncome, provisions, equity, paidInShareCapital, stateAssets
  • Angajați: employees (numărul mediu de salariați declarat)
  • Indicatori: netMargin, grossMargin, debtToEquity, returnOnEquity, returnOnAssets, revenueGrowthYoY
  • denumirea firmei și codul CAEN declarate în bilanț, plus indicatorii bruți (cod, valoare, etichetă)

Valorile sunt în RON; un câmp lipsă din bilanț apare ca null.

Surse

Bilanțurile provin din serviciul web public ANAF pentru situații financiare. Starea din registru, codurile CAEN și reprezentanții provin din datele deschise ONRC (data.gov.ro, licență CC-BY 4.0), dintr-un instantaneu lunar; pentru uz juridic verifică datele curente la ONRC. Pentru datele fiscale de bază (TVA, inactivi, e-Factura) vezi API verificare TVA.

Endpoint-uri și prețuri

ServiciuEndpointCredite≈ EUR
Financial statements
Up to 5 years of filed accounts + ratios (RON)		GET /v1/company/{cui}/financials
MCP get_company_financials		3€0.015
Legal representatives (ONRC)
Trade-register status, CAEN codes, representatives (name, role)		GET /v1/company/{cui}/representatives
MCP get_company_representatives		5€0.025
Risk report (KYB)
Status + financials + court cases + registry, score 0-100 with explained flags		GET /v1/company/{cui}/risk-report
MCP get_company_risk_report		30€0.150

Pachete preplătite (TVA inclus): €5 = 1,000 · €20 = 5,000 · €100 = 30,000 credits. 100 credite gratuite per cheie, fără contract.

De ce HowToRomania

  • JSON în engleză, gata de folosit de agenți AI și de cod
  • Firme, dosare în instanță, e-Factura și legislație în vigoare într-un singur API
  • REST și server MCP remote cu aceleași chei
  • Plată per apel (1 credit = 0,005 €, pachetul minim), fără contract; erorile și indisponibilitatea sursei nu se taxează (raportul de risc parțial se taxează integral)
  • 100 de credite gratuite la fiecare cheie
  • Abonamente pentru volume mari, la cerere: hello@howtoromania.io.

Întrebări frecvente

Pentru câți ani primesc bilanțul?

Între 1 și 5 ani de situații financiare publicate, cu parametrul years (implicit 3).

Ce este „raportul de risc”?

Un singur apel care combină starea, bilanțurile, dosarele și datele din registru într-un scor 0-100 cu motivele explicate (30 de credite).

Cât costă?

Plătești per apel reușit, în credite (1 credit = 0,005 €, pachetul minim). Fiecare cheie primește 100 de credite gratuite. Pachete: 5 € = 1.000 credite, 20 € = 5.000 credite, 100 € = 30.000 credite. Preplătit, fără contract; erorile, „negăsit” și apelurile la care sursa (ex. ANAF) nu răspunde nu se taxează. Un raport de risc cu secțiuni indisponibile se taxează integral.

Pot testa fără cont?

Da. Cheia demo htr_demo merge, cu o limită zilnică per IP, pe căutarea firmei după CUI, dosarul după număr, validarea și parsarea e-Factura, căutarea în legislație, articolele în vigoare și actele noi. O cheie gratuită cu 100 de credite se obține cu un singur POST la /v1/keys.

Este un serviciu oficial ANAF?

Nu. HowToRomania este un serviciu independent care preia surse publice (ANAF, date deschise ONRC, BNR, portal.just.ro, legislatie.just.ro) și le livrează ca JSON. Nu este afiliat sau aprobat de vreo autoritate. Doar informativ; nu este consultanță juridică sau de credit.