Business v1 / Persoane

Persoane cu multe firme

Persoanele legate de un număr mare de firme, ordonate descrescător. Nu e o acuzaţie: administratorii profesionişti şi practicienii în insolvenţă apar în mod normal aici.

GET

https://oneapi.ro/api/business/v1/persoane/multi-firme

Parametri de interogare

NumeTipDescriereValori acceptate

minopțional integer | null Pragul minim de firme per persoană; implicit 10, minim acceptat 2. 1

Cum se comportă

Numele singur nu identifică pe nimeni, iar registrul nu publică CNP-ul. De aceea fiecare persoană vine cu identificator (UUID derivat din nume + judeţul naşterii + ziua naşterii) şi cu judet_nastere. Data naşterii nu se stochează şi nu se expune — intră doar în identificator. Unde registrul nu dă data naşterii (13% din menţiuni, mai ales lichidatori persoane juridice), persoana rămâne distinctă la fiecare firmă, ca să nu inventăm legături.
Persoanele legate de un număr mare de firme — administratori „în serie", puncte de interes pentru analiză de reţea.
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.

La ce folosește

Identificarea administratorilor „în serie", puncte de pornire pentru investigaţii.
Un semnal de risc pentru echipele de conformitate.
Alimentarea unui tablou de bord de analiză de reţea cu nodurile cele mai dense.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

prag_minim integer Pragul minim aplicat la filtrare.

persoane[].id integer Identificatorul intern.

persoane[].nume string Numele.

persoane[].nr_firme integer Numărul de firme.

persoane[].identificator string Identificatorul stabil al persoanei (UUID), derivat din nume + judeţul naşterii + ziua naşterii. Spre deosebire de id, nu se schimbă la reimport. Foloseşte-l ca să ştii dacă administratorul a două firme e acelaşi om ori doi omonimi.

persoane[].judet_nastere string Judeţul naşterii, aşa cum îl publică registrul. Împreună cu identificator, deosebeşte omonimii la afişare.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/persoane/multi-firme?min=5

{
    "data": {
        "prag_minim": 5,
        "persoane": [
            {
                "id": 14400593,
                "identificator": "1a316a50-157a-5cc5-a545-86f333631344",
                "nume": "BERNEANU NICOLETA - SOFIA",
                "judet_nastere": "Bucureşti",
                "nr_firme": 1878
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/multi-firme?min=20

{
    "data": {
        "prag_minim": 20,
        "persoane": [
            {
                "id": 14400593,
                "identificator": "1a316a50-157a-5cc5-a545-86f333631344",
                "nume": "BERNEANU NICOLETA - SOFIA",
                "judet_nastere": "Bucureşti",
                "nr_firme": 1878
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/persoane/multi-firme?min=100

{
    "data": {
        "prag_minim": 100,
        "persoane": [
            {
                "id": 14400593,
                "identificator": "1a316a50-157a-5cc5-a545-86f333631344",
                "nume": "BERNEANU NICOLETA - SOFIA",
                "judet_nastere": "Bucureşti",
                "nr_firme": 1878
            }
        ]
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
422	validare	Un parametru nedeclarat ori o valoare care nu trece validarea (`min`). Câmpul vinovat e în `detalii`.
429	cota_depasita	Cota 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": "Un parametru nedeclarat ori o valoare care nu trece validarea (min). Câmpul vinovat e în detalii.",
        "detalii": {
            "min": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}