oneapi
Autentificare
Business v1 / Firme

Istoricul reprezentanţilor

Administratorii, lichidatorii şi ceilalţi reprezentanţi ai firmei de-a lungul timpului, cu perioada în care apar în registru.

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

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ă

  • Sursa publică reprezentanţii abia din noiembrie 2025, deci istoricul începe acolo, nu în 2020 ca la stări.
  • ⚠️ Acoperirea devine completă abia din 2 martie 2026. Între noiembrie 2025 şi februarie 2026, ONRC publica un fişier mic (700.000 de legături, mai ales lichidatori); din martie 2026 el are 2,9 milioane. Un administrator care apare cu vazut_de_la 2026-03-02 era, cel mai probabil, în funcţie şi înainte — doar că nu era publicat.
  • ⚠️ Perioadele sunt de observaţie, ca la stări: data e cea a snapshot-ului, nu a hotărârii.
  • Se păstrează doar numele, calitatea şi localitatea din registru. Datele de naştere publicate de ONRC nu se citesc şi nu se stochează.

La ce folosește

  • Cine administra firma la data unui contract sau a unei facturi.
  • Schimbările de conducere dintr-o firmă, ca semnal în analiza de risc.
  • Legătura dintre o persoană şi firmele pe care le-a condus în trecut.

Structura răspunsului

CâmpTipDescriere
data[].identificator string Identificatorul stabil al persoanei (UUID), acelaşi ca la /firme/{cui}/persoane: spune dacă e acelaşi om ori un omonim.
data[].judet_nastere string | null Judeţul naşterii, din nomenclatorul de persoane.
data[].persoana_id integer | null Identificatorul persoanei în nomenclatorul propriu, unde ea mai apare şi azi; null dacă nu mai e legată de nicio firmă.
data[].nume string Numele, aşa cum e scris în registru.
data[].calitate string Calitatea: administrator, lichidator, reprezentant al persoanei juridice…
data[].judet string | null Judeţul din adresa persoanei, unde registrul îl publică.
data[].localitate string | null Localitatea din adresa persoanei, unde registrul o publică.
data[].sursa string Fişierul ONRC din care vine: onrc:reprezentanti_legali ori onrc:reprezentanti_if (întreprinderi familiale).
data[].vazut_de_la string Primul snapshot în care persoana apare cu calitatea asta la firmă.
data[].vazut_pana_la string | null Ultimul snapshot în care mai apare; null dacă e încă în funcţie.
data[].in_functie boolean true dacă apare în cel mai recent snapshot procesat.
meta.paginare.pagina integer Pagina curentă, numărată de la 1.
meta.paginare.per_pagina integer Câte înregistrări are o pagină.
meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.
meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/14399840/istoric/reprezentanti
{
    "data": [
        {
            "persoana_id": 17035225,
            "identificator": "c7ea7348-e5eb-5c10-8858-1414e23157e2",
            "nume": "VAID HELEN",
            "judet_nastere": null,
            "calitate": "administrator",
            "judet": null,
            "localitate": null,
            "sursa": "onrc:reprezentanti_legali",
            "vazut_de_la": "2026-09-02",
            "vazut_pana_la": null,
            "in_functie": true
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 8,
            "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ă.
422validareUn parametru nedeclarat, în afară de paginare şi lang.
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": "Un parametru nedeclarat, în afară de paginare şi lang.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}