Business v1 / Firme

Istoricul stărilor

Prin ce stări a trecut firma — funcţiune, dizolvare, insolvenţă, radiere — şi între ce date apare fiecare în registru.

GET

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

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ă

Istoricul e construit din snapshot-urile ONRC arhivate, din mai 2020 încoace. O firmă poate avea mai multe stări simultan (de pildă funcțiune şi valabilitate sediu expirată).
⚠️ Datele sunt de observaţie, nu de eveniment. ONRC nu publică momentul schimbării, ci doar starea din ziua snapshot-ului. „Văzută de la 2023-01-07" înseamnă că starea a apărut între snapshot-ul precedent şi acela — până în 2025 snapshot-urile sunt la circa trei luni distanţă, apoi lunare.

La ce folosește

Verificarea dacă un partener a mai fost în insolvenţă sau dizolvare în trecut.
Reconstituirea momentului în care o firmă a fost radiată ori reactivată.
Semnale de risc pentru un scoring propriu: câte schimbări de stare are firma.

Structura răspunsului

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

CâmpTipDescriere

stare.cod string Codul stării, din nomenclatorul ONRC.

stare.denumire string Starea, în clar: funcțiune, radiată, dizolvare…

stare.categorie string Categoria stării: activa, radiata, insolventa, dizolvata, suspendata, alta.

vazut_de_la string Primul snapshot ONRC în care firma apare cu starea asta.

vazut_pana_la string | null Ultimul snapshot în care mai apare; null dacă e încă valabilă.

in_vigoare boolean true dacă starea apare în cel mai recent snapshot procesat.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/14399840/istoric/stari

{
    "data": [
        {
            "stare": {
                "cod": "2065",
                "denumire": "mandat administratori expirat",
                "categorie": "alta"
            },
            "vazut_de_la": "2026-04-03",
            "vazut_pana_la": "2026-04-03",
            "in_vigoare": false
        }
    ]
}

GEThttps://oneapi.ro/api/business/v1/firme/6719278/istoric/stari

{
    "data": [
        {
            "stare": {
                "cod": "1050",
                "denumire": "reorganizare - fuziune prin absorbție",
                "categorie": "alta"
            },
            "vazut_de_la": "2025-12-08",
            "vazut_pana_la": "2026-03-02",
            "in_vigoare": false
        }
    ]
}

GEThttps://oneapi.ro/api/business/v1/firme/2054341/istoric/stari

{
    "data": [
        {
            "stare": {
                "cod": "1084",
                "denumire": "radiată",
                "categorie": "radiata"
            },
            "vazut_de_la": "2025-11-13",
            "vazut_pana_la": null,
            "in_vigoare": true
        }
    ]
}

GEThttps://oneapi.ro/api/business/v1/firme/24890577/istoric/stari

{
    "data": [
        {
            "stare": {
                "cod": "2114",
                "denumire": "bilanțul anual nedepus la registrul comerțului pe anul 2008",
                "categorie": "alta"
            },
            "vazut_de_la": "2020-05-02",
            "vazut_pana_la": "2026-01-09",
            "in_vigoare": false
        }
    ]
}

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."
            ]
        }
    }
}