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. Returnează primele 50 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 sunt sortate automat: potrivire exactă → firmele active → scor FULLTEXT. Maxim 50 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, ONRC, TVA, e-Factura, administratori, EUID, scor risc, limită credit.

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": "STR. ALEXEI TOLSTOI, NR.8, Bacău",
  "judet": "BACĂU",
  "codPostal": "600093",
  "nrRegCom": "J04/58/1992",
  "codCaen": "4752",
  "dataInregistrare": "1992-03-20",
  "stareInregistrare": "INREGISTRAT din data 20.03.1992",
  "formaJuridica": "SOCIETATE COMERCIALĂ CU RĂSPUNDERE LIMITATĂ",
  "euid": "ROONRC.J04/58/1992",
  "stareOnrc": "funcțiune",
  "activ": true,
  "platitorTVA": true,
  "tvaIncasare": false,
  "splitTVA": false,
  "eFactura": true,
  "inInsolventa": false,
  "inFaliment": false,
  "areDatoriiANAF": false,
  "administratori": [
    { "name": "PAVAL DRAGOȘ", "role": "administrator" },
    { "name": "PAVAL ADRIAN", "role": "administrator" }
  ],
  "caenAutorizate": ["4752", "4741", "4742"],
  "scorRisc": 15,
  "riscNivel": "scazut",
  "scorRiscFC": 82,     // scor FirmaCheck 0-100
  "limitaCreditFC": 5200000  // limită credit calculată (RON)
}

cui

integer

CUI firmă

denumire

string

Denumire oficială

adresa

string

Adresa sediului social

euid

string

European Unique Identifier ONRC

stareOnrc

string

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

activ

boolean

Activ fiscal la ANAF

platitorTVA

boolean

Înregistrat în scop TVA

eFactura

boolean

Înregistrat în RO e-Factura

inInsolventa

boolean

Procedură de insolvență activă

inFaliment

boolean

Procedură de faliment activă

areDatoriiANAF

boolean

Datorii restante la buget

administratori

array

Administratori/reprezentanți ONRC

caenAutorizate

array

Coduri CAEN autorizate

nrRegCom

string

Nr. Registrul Comerțului

scorRiscFC

integer

Scor risc 0-100 (100=risc maxim)

limitaCreditFC

number

Limită credit recomandată (RON)

📊 Date financiare

Istoricul indicatorilor financiari anuali direct din ANAF oficial (webservicesp.anaf.ro) — până la 6 ani disponibili, pornind din anul curent.

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 []. Valorile includ profitNet calculat automat (Profit net − Pierdere netă).

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"
}

💻 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