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

Exemplu răspuns

[
  {
    "cui": 2816464,
    "name": "DEDEMAN SRL",
    "county": "Bacău",
    "locality": "Bacău",
    "stare": "funcțiune",
    "activa": true
  },
  {
    "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 (cifră afaceri, profit, angajați etc.)

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

Parametru	Tip	Obligatoriu	Descriere
cui	integer	obligatoriu	CUI numeric al firmei

Exemplu request

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

Exemplu răspuns

[
  {
    "an": 2023,
    "cifraAfaceri": 9876543210,
    "profitNet": 543210000,
    "totalActive": 7654321000,
    "datorii": 2345678000,
    "capitalPropriu": 5308643000,
    "nrAngajati": 12500
  }
]

📋 Bilanț detaliat

Date bilanțiere detaliate pentru un an specific

GET /api.php?action=balance&cui={cui}&an={an} Bilanț detaliat pe an

Parametru	Tip	Obligatoriu	Descriere
cui	integer	obligatoriu	CUI numeric al firmei
an	integer	opțional	Anul bilanțului (implicit: ultimul disponibil)

Exemplu request

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

⚠️ 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