Pentru dezvoltatori

API public ICA - date oficiale, gratuit

Acces programatic la firme, bilanțuri, scor de sector și verificări - direct din surse oficiale (ONRC, Ministerul Finanțelor, ANAF live, BNR). Fără cont, fără cheie, doar o limită rezonabilă per IP.

Bază: /api/v1 Auth: niciuna (free tier) Limită: 120 cereri/min (40/min la /verifica) Format: JSON · CORS deschis

Firme

Endpoint	Descriere
`GET /api/v1/firma/{cui}`	Profil: identitate + ultimul an financiar + stare ONRC. Adaugă `?live=1` pentru status fiscal ANAF în timp real.
`GET /api/v1/firma/{cui}/bilant`	Istoric financiar complet (toți anii din bilanțurile publice).
`GET /api/v1/firma/{cui}/sector`	Benchmark de sector - percentile pe CAEN×județ×an.
`GET /api/v1/firma/{cui}/analiza`	Concluzia ICA - interpretare narativă prudentă (scor, puncte forte, atenții, „pe scurt") din date publice.
`GET /api/v1/cauta?q=`	Caută firme după denumire sau CUI.
`GET /api/v1/firme?caen=&judet=&an=&ca_min=&profit_min=&sort=`	Căutare avansată după criterii financiare (paginat, 50/pag).

Verificări & nomenclatoare

Endpoint	Descriere
`GET /api/v1/verifica/cui/{cui}`	Verificare ANAF în timp real: TVA, inactiv fiscal, e-Factura, stare.
`GET /api/v1/verifica/vat/{vat}`	Validare cod TVA UE (VIES).
`GET /api/v1/verifica/iban/{iban}`	Validare IBAN (MOD-97) + identificare bancă.
`GET /api/v1/caen?q=`	Caută cod CAEN după denumire sau cod.
`GET /api/v1/curs`	Curs valutar BNR de referință.

Încearcă acum

Apasă pe un exemplu (se deschide răspunsul JSON):

Format răspuns

{
  "ok": true,
  "data": { ... }
}

// la eroare:
{
  "ok": false,
  "error": { "code": "not_found", "message": "Firmă negăsită pentru acest CUI." }
}

Coduri: 200 ok · 404 negăsit · 422 parametru invalid · 429 limită depășită · 500 eroare. Câmpurile numerice sunt numere reale (nu text).

Date din surse oficiale, actualizate periodic; status-ul fiscal (?live=1 și /verifica/cui) este preluat în timp real de la ANAF. În curând: chei API pentru limite mai mari și conector pentru asistenți AI (MCP). Folosind acest API, ești de acord să citezi sursa „date via ICA".