oneapi
Autentificare
Business v1 / Firme

Firme conexe

Firmele legate de aceasta prin persoane comune (administratori/asociați), ordonate după numărul de
persoane comune. Paginat (?pagina=&per_pagina=). Util pt identificarea grupurilor de firme.

GET
https://oneapi.ro/api/business/v1/firme/{cui}/conexe

Parametri de cale

NumeTipDescriereExemplu
cuiobligatoriu string Codul de identificare fiscală al firmei, fără prefixul RO (ex. 6719278).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Firmele conexe firmei date — cele care împart cel puţin o persoană (administrator sau asociat). E baza pentru grafuri de proprietate şi control.
  • Pentru calea concretă între două firme (cum sunt legate, prin cine), foloseşte /firme/{cui}/conexe/{cui2} — o căutare de drum în graful de conexiuni, până la o adâncime dată.
  • Cum identificăm persoana: după nume + judeţul naşterii + ziua naşterii, trecute printr-o amprentă. Datele de naştere nu se stochează nicăieri şi nu apar în API; amprenta serveşte doar la separarea omonimilor. Până pe 18 sep 2026 identitatea era „nume + judeţ”, iar ONRC lasă judeţul gol la 99,3% dintre reprezentanţi: toţi omonimii din ţară deveneau o singură persoană, iar firme fără nicio legătură reală apăreau conexe (68% dintre muchiile grafului). Unde registrul n-are data naşterii (13% din menţiuni, mai ales lichidatori persoane juridice), persoana rămâne distinctă la fiecare firmă: preferăm o legătură reală pierdută uneia inventate.
  • Rămân omisiuni posibile: aceeaşi persoană scrisă diferit în registru (iniţiale, diacritice lipsă) apare ca două persoane.

La ce folosește

  • Grafuri de proprietate şi mapare de grupuri de firme.
  • Analiză de risc pe expunerea la un grup.
  • Investigaţii şi jurnalism de date.

Structura răspunsului

CâmpTipDescriere
data[].cui integer Codul fiscal.
data[].denumire string | null Denumirea.
data[].stare string | null Starea firmei, ca obiect: denumire e textul brut din ONRC (107 valori distincte folosite), categorie e clasificarea noastră în 7 cutii — activa, suspendata, dizolvata, lichidare, radiata, insolventa, alta — pe care o foloseşti ca să filtrezi sau să grupezi. cod e codul ONRC al stării.
data[].judet string | null Judeţul.
data[].localitate string | null Localitatea.
data[].persoane_comune integer Câte persoane au mandat în ambele firme.
meta.paginare.pagina integer Pagina curentă.
meta.paginare.per_pagina integer Rezultate pe pagină.
meta.paginare.total integer Total rezultate.
meta.paginare.pagini integer Număr de pagini.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/conexe
{
    "data": [
        {
            "cui": 16114842,
            "denumire": "MASCO MANAGEMENT SRL",
            "stare": {
                "cod": "1084",
                "denumire": "radiată",
                "categorie": "radiata"
            },
            "judet": "București",
            "localitate": "București Sectorul 5",
            "persoane_comune": 1
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 4,
            "pagini": 1
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitFirma cu CUI [{cui}] nu a fost găsită.
422validareRuta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}