Business v1 / Firme

Administratori

Doar persoanele cu rol de administrator (subset al /persoane).

GET

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

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ă

Doar persoanele cu rol de administrator, filtrate din setul complet de persoane. Pentru asociaţi, lichidatori şi restul rolurilor, foloseşte /firme/{cui}/persoane.
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

Aflarea cine poate semna în numele firmei, înainte de a trimite un contract.
Verificarea identităţii semnatarului dintr-un document primit.
Ecranarea persoanelor cu drept de reprezentare, la onboarding.

Structura răspunsului

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

CâmpTipDescriere

nr_persoane integer Numărul de persoane.

persoane[].id integer Identificatorul intern.

persoane[].identificator string | null 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[].nume string Numele.

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

persoane[].rol string | null Rolul deţinut (administrator, asociat…).

persoane[].localitate string | null Localitatea.

persoane[].judet string | null Judeţul.

persoane[].sursa string | null Sursa datelor.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/administratori

{
    "data": {
        "nr_persoane": 5,
        "persoane": [
            {
                "id": 15553509,
                "identificator": "e5569fe9-133d-5746-8668-958e87a3f775",
                "nume": "ILIN EMIL MARIAN",
                "judet_nastere": "Teleorman",
                "rol": "administrator",
                "localitate": null,
                "judet": null,
                "sursa": "onrc:reprezentanti_legali"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/administratori

{
    "data": {
        "nr_persoane": 3,
        "persoane": [
            {
                "id": 16179051,
                "identificator": "5b490f02-42d5-5b4e-9eba-078280578980",
                "nume": "OLIVIER PETRUS JACOBUS PRETORIUS",
                "judet_nastere": null,
                "rol": "administrator",
                "localitate": null,
                "judet": null,
                "sursa": "onrc:reprezentanti_legali"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/2054341/administratori

{
    "data": {
        "nr_persoane": 1,
        "persoane": [
            {
                "id": 14191425,
                "identificator": "28f58969-c336-575b-9b09-e398e45a5a70",
                "nume": "ALGESO ADMIN S.R.L.",
                "judet_nastere": null,
                "rol": "administrator",
                "localitate": "Roman",
                "judet": "Neamţ",
                "sursa": "onrc:reprezentanti_legali"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/24890577/administratori

{
    "data": {
        "nr_persoane": 1,
        "persoane": [
            {
                "id": 15639793,
                "identificator": "d7139e42-9aac-5faa-9e15-ae2155e89da8",
                "nume": "IZSÓ CSABA",
                "judet_nastere": "Harghita",
                "rol": "administrator",
                "localitate": null,
                "judet": null,
                "sursa": "onrc:reprezentanti_legali"
            }
        ]
    }
}

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.
404	negasit	Firma cu CUI [{cui}] nu a fost găsită.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
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": "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."
            ]
        }
    }
}