API Docs — CUIScan.ro

Base URL

https://cuiscan.ro/api.php

Toate request-urile sunt GET. Parametrul action specifică endpoint-ul. Răspunsurile sunt în format JSON UTF-8.

⏱ Rate Limiting

Limite pentru utilizare corectă și stabilitatea serviciului

100

request-uri / oră / IP

10

request-uri / secundă

∞

fără cheie API necesară

Depășirea limitelor returnează HTTP 429 Too Many Requests. Adaugă un delay de minim 500ms între request-uri în producție.

❌ Coduri de eroare

Toate erorile returnează JSON cu câmpul error

HTTP	Descriere	Exemplu răspuns
400	Parametri lipsă sau invalizi	`{"error":"CUI invalid"}`
404	Firma nu a fost găsită	`{"error":"Firma negăsită"}`
429	Rate limit depășit	`{"error":"Too many requests"}`
500	Eroare server intern	`{"error":"Eroare internă"}`

🔍 Search firme

Caută firme după denumire sau CUI. Sursa: baza de date ONRC (4.1M firme) — mereu actualizată. Returnează primele 30 de rezultate, active primele.

GET /api.php?action=search&q={termen} Caută după denumire sau CUI

Parametru	Tip	Obligatoriu	Descriere
action	string	obligatoriu	Valoare fixă: `search`
q	string	obligatoriu	Denumire firmă (min. 2 caractere) sau CUI numeric

Exemplu request

GET https://cuiscan.ro/api.php?action=search&q=dedeman

Rezultatele vin din baza de date ONRC (4.1M firme, actualizată lunar). Sortare: potrivire exactă → firmele active. Maxim 30 rezultate.

Exemplu răspuns

[
  {
    "cui": 2816464,
    "name": "DEDEMAN SRL",
    "county": "Bacău",
    "locality": "Bacău",
    "stare": "funcțiune",    // stare ONRC oficială
    "activa": true              // true = în funcțiune
  },
  {
    "cui": 6496311,
    "name": "DEDEMAN COMPANY SRL",
    "county": "Bacău",
    "locality": "Bacău",
    "stare": "radiată",
    "activa": false
  }
]

cui

integer

Cod Unic de Identificare

name

string

Denumire firmă

county

string

Județul sediului

locality

string

Localitatea sediului

stare

string

Starea ONRC (funcțiune, radiată etc.)

activa

boolean

true dacă firma e în funcțiune

🏢 Date firmă

Date complete despre o firmă: ANAF live, sediu, TVA, administratori ONRC, scor risc Altman Z'.

GET /api.php?action=company&cui={cui} Date complete firmă

Parametru	Tip	Obligatoriu	Descriere
action	string	obligatoriu	Valoare fixă: `company`
cui	integer	obligatoriu	CUI numeric al firmei (fără prefixul RO)

Exemplu request

GET https://cuiscan.ro/api.php?action=company&cui=2816464

Exemplu răspuns (simplificat)

{
  "cui": 2816464,
  "denumire": "DEDEMAN SRL",
  "adresa": "Calea Romanului 24, Bacău",
  "judet": "Bacău",
  "localitate": "Bacău",
  "codPostal": "600001",
  "stare": "ACTIV",
  "dataInregistrare": "1992-03-20",
  "nrRegCom": "J04/58/1992",
  "platitorTva": true,
  "tvaLaIncasare": false,
  "codCaen": "4752",
  "denumireCaen": "Comerț cu amănuntul al articolelor de fierărie...",
  "capitalSocial": 1000000,
  "formaJuridica": "SRL",
  "administratori": [
    { "name": "PAVAL DRAGOȘ", "role": "Administrator" }
  ],
  "altmanZ": {
    "score": 4.82,
    "zona": "Sigură",
    "risc": "Scăzut"
  }
}

cui

integer

CUI firmă

denumire

string

Denumire oficială

adresa

string

Adresa sediului social

stare

string

Stare fiscală ANAF

platitorTva

boolean

Înregistrat în scop TVA

tvaLaIncasare

boolean

TVA la încasare activ

codCaen

string

Cod activitate principală

capitalSocial

number

Capital social (RON)

nrRegCom

string

Nr. Registrul Comerțului

administratori

array

Lista administratori ONRC

altmanZ

object

Scor risc Altman Z'

dataInregistrare

string

Data înregistrării (ISO)

📊 Date financiare

Istoricul indicatorilor financiari anuali direct din ANAF oficial — ultimii 8 ani disponibili.

GET /api.php?action=financials&cui={cui} Indicatori financiari anuali (ANAF)

Parametru	Tip	Obligatoriu	Descriere
action	string	obligatoriu	Valoare fixă: `financials`
cui	integer	obligatoriu	CUI numeric al firmei (fără RO)

Sursa: ANAF oficial (webservicesp.anaf.ro). Datele sunt actualizate anual după depunerea bilanțurilor. Firmele fără bilanț depus returnează array gol [].

Exemplu request

GET https://cuiscan.ro/api.php?action=financials&cui=2816464

Exemplu răspuns

[
  {
    "an": 2024,
    "activeImobilizate": 4508967346,
    "activeCirculante": 2333954468,
    "stocuri": 2171134030,
    "creante": 69341056,
    "casaConturi": 90567085,
    "datorii": 1871265759,
    "capitaluri": 4974759088,
    "capitalSubscris": 2570500000,
    "cifraAfaceri": 12294042595,
    "venituriTotale": 12390803495,
    "cheltuieliTotale": 10503086092,
    "profitBrut": 1887717403,
    "profitNet": 1636814708,
    "pierdereNeta": 0,
    "nrAngajati": 12313
  },
  { "an": 2023, ... date an anterior ... }
]

an

integer

Anul financiar

cifraAfaceri

number

Cifra de afaceri netă (RON)

profitNet

number

Profit net (negativ = pierdere)

activeImobilizate

number

Active imobilizate total

activeCirculante

number

Active circulante total

datorii

number

Datorii totale

capitaluri

number

Capitaluri proprii total

venituriTotale

number

Venituri totale

cheltuieliTotale

number

Cheltuieli totale

nrAngajati

integer

Nr. mediu salariați

📋 Bilanț detaliat

Toți indicatorii bilanțieri (I1-I20) pentru un an specific, direct din ANAF oficial.

GET /api.php?action=balance&cui={cui}&an={an} Bilanț complet I1-I20 (ANAF)

Parametru	Tip	Obligatoriu	Descriere
action	string	obligatoriu	Valoare fixă: `balance`
cui	integer	obligatoriu	CUI numeric al firmei
an	integer	opțional	Anul bilanțului (implicit: anul curent - 1)

Exemplu request

GET https://cuiscan.ro/api.php?action=balance&cui=2816464&an=2023

Exemplu răspuns

{
  "an": 2023,
  "cui": 2816464,
  "denumire": "DEDEMAN S.R.L.",
  "caen": 4752,
  "denCaen": "Comerț cu amănuntul al articolelor de fierărie...",
  "sursa": "ANAF",
  "indicatori": [
    { "indicator": "I1", "denumire": "Active imobilizate - Total", "valoare": 4329508470 },
    { "indicator": "I2", "denumire": "Active circulante - Total", "valoare": 2205840147 },
    { "indicator": "I7", "denumire": "Datorii", "valoare": 1696591870 },
    { "indicator": "I13", "denumire": "Cifra de afaceri netă", "valoare": 11545530630 },
    { "indicator": "I18", "denumire": "Profit net", "valoare": 1534733147 },
    { "indicator": "I20", "denumire": "Număr mediu salariați", "valoare": 12113 }
    // ... toți indicatorii I1-I20
  ]
}

an

integer

Anul bilanțului

cui

integer

CUI firmă

denumire

string

Denumire firmă

caen

integer

Cod CAEN activitate

sursa

string

Întotdeauna "ANAF"

indicatori

array

Lista I1-I20 cu denumire și valoare

⚠️ Insolvență BPI

Verificare proceduri de insolvență din Buletinul Procedurilor de Insolvență (BPI)

GET /api.php?action=insolventa&cui={cui} Proceduri insolvență BPI

Parametru	Tip	Obligatoriu	Descriere
cui	integer	obligatoriu	CUI numeric al firmei

Exemplu request

GET https://cuiscan.ro/api.php?action=insolventa&cui=2816464

Exemplu răspuns

{
  "inInsolventa": false,
  "proceduri": [],
  "sursa": "BPI"
}

⚖️ Dosare instanță ECRIS

Dosare din Portalul Instanțelor de Judecată (portal.just.ro)

GET /api.php?action=dosare&cui={cui}&denumire={denumire} Dosare ECRIS instanțe

Parametru	Tip	Obligatoriu	Descriere
cui	integer	obligatoriu	CUI numeric al firmei
denumire	string	opțional	Denumirea firmei (îmbunătățește rezultatele)

Exemplu request

GET https://cuiscan.ro/api.php?action=dosare&cui=2816464&denumire=DEDEMAN+SRL

Exemplu răspuns

{
  "total": 3,
  "dosare": [
    {
      "numar": "1234/110/2023",
      "data": "2023-05-12",
      "instanta": "Tribunalul Bacău",
      "obiect": "Pretenții",
      "parte": "Reclamant",
      "stadiu": "În judecată"
    }
  ]
}

📝 Date RECOM ONRC

Date oficiale din Registrul Comerțului: sedii, puncte de lucru, obiect de activitate

GET /api.php?action=recom&cui={cui} Date RECOM oficiale

Parametru	Tip	Obligatoriu	Descriere
cui	integer	obligatoriu	CUI numeric al firmei

Exemplu request

GET https://cuiscan.ro/api.php?action=recom&cui=2816464

🔎 BPI Detalii

Detalii complete despre o procedură specifică din BPI

GET /api.php?action=bpi&id={id} Detalii procedură BPI

Parametru	Tip	Obligatoriu	Descriere
id	string	obligatoriu	ID-ul procedurii BPI (obținut din action=insolventa)

Exemplu request

GET https://cuiscan.ro/api.php?action=bpi&id=12345

👤 Alte firme ale administratorului

Găsește toate firmele în care o persoană apare ca administrator sau reprezentant legal

GET /api.php?action=admin-firme&adminName={nume}&excludeCui={cui} Firme per administrator

Parametru	Tip	Obligatoriu	Descriere
adminName	string	obligatoriu	Numele complet al administratorului (UPPERCASE recomandat)
excludeCui	integer	opțional	CUI firmă de exclus din rezultate (de obicei firma curentă)

Exemplu request

GET https://cuiscan.ro/api.php?action=admin-firme&adminName=PAVAL+DRAGOS&excludeCui=2816464

Exemplu răspuns

{
  "results": [
    {
      "cui": 12345678,
      "denumire": "ALTĂ FIRMĂ SRL",
      "county": "București",
      "statusLabel": "Administrator"
    }
  ],
  "total": 1,
  "query": "PAVAL DRAGOS"
}

📊 Comparație CAEN

Top firme active cu același cod CAEN, sortate după cifra de afaceri. Date financiare din ANAF, lista firme din ONRC.

GET /api.php?action=caen-comparatie&caen={cod}&cui={cui} Top firme pe sector CAEN

Parametru	Tip	Obligatoriu	Descriere
action	string	obligatoriu	Valoare fixă: `caen-comparatie`
caen	string	obligatoriu	Cod CAEN din 4 cifre (ex: 1013, 4752)
cui	integer	opțional	CUI firmă de referință — va fi evidențiată în clasament
limit	integer	opțional	Număr maxim rezultate (5-20, implicit 15)

Acest endpoint face apeluri ANAF pentru fiecare firmă din clasament. Timpul de răspuns poate fi 15–30 secunde. Recomandăm folosirea cu timeout extins.

Exemplu request

GET https://cuiscan.ro/api.php?action=caen-comparatie&caen=1013&cui=4705349&limit=10

Exemplu răspuns

{
  "firme": [
    {
      "cui": 4705349,
      "denumire": "CARNIPROD SRL",
      "judet": "Tulcea",
      "localitate": "Municipiul Tulcea",
      "stare": "funcțiune",
      "activa": true,
      "ca": 94509940,        // cifra de afaceri RON
      "angajati": 265,
      "profit": 910706,
      "an": 2025,           // anul datelor financiare
      "isRef": true,          // firma de referinta (cui din parametru)
      "rank": 1
    }
  ],
  "total": 25,              // total firme cu date financiare gasite
  "rangRef": 1,            // pozitia firmei de referinta
  "caen": "1013"
}

firme

array

Lista firmelor din clasament

total

integer

Total firme cu date financiare găsite

rangRef

integer

Poziția firmei de referință în clasament

caen

string

Codul CAEN interogat

ca

number

Cifra de afaceri (RON)

angajati

integer

Număr mediu salariați

profit

number

Profit net (negativ = pierdere)

isRef

boolean

true dacă e firma de referință

rank

integer

Poziția în clasament

💻 Exemple de integrare

Cod gata de folosit în diferite limbaje

JavaScript (fetch)

// Caută o firmă după denumire
const response = await fetch(
  'https://cuiscan.ro/api.php?action=search&q=dedeman'
);
const firms = await response.json();
console.log(firms[0]); // { cui: 2816464, name: "DEDEMAN SRL", ... }

// Date complete firmă
const data = await fetch(
  'https://cuiscan.ro/api.php?action=company&cui=2816464'
).then(r => r.json());
console.log(data.denumire, data.platitorTva);

Python (requests)

import requests

BASE = 'https://cuiscan.ro/api.php'

# Caută firmă
firms = requests.get(BASE, params={'action':'search', 'q':'dedeman'}).json()

# Date complete
company = requests.get(BASE, params={'action':'company', 'cui':2816464}).json()
print(company['denumire'], company['platitorTva'])

PHP (curl)

$response = file_get_contents(
    'https://cuiscan.ro/api.php?action=company&cui=2816464'
);
$company = json_decode($response, true);
echo $company['denumire']; // DEDEMAN SRL

API CUIScan.ro