oneapi
Autentificare
Business v1 / Statistici ONRC

Profil ţară (capital străin)

Societăţile cu participare străină şi capitalul subscris pentru o ţară, la o lună (implicit
ultima). Numele ţării se potriveşte fără diacritice şi fără majuscule.

GET
https://oneapi.ro/api/business/v1/statistici/onrc/tari/{nume}

Parametri de cale

NumeTipDescriereExemplu
numeobligatoriu string Numele ţării, în română şi cu diacritice opţionale (ex. italia).

Parametri de interogare

NumeTipDescriereValori acceptate
perioadaopțional string | null Luna dorită, ca AAAA-LL. Implicit ultima în care ţara apare. ex. 2026-07ex. 2025-09

Cum se comportă

  • Câte societăţi cu participare străină din ţara asta există în România şi cu ce capital subscris, în lei, dolari şi euro. Numele se potriveşte fără diacritice şi fără majuscule: italia, Italia şi ITALIA duc la acelaşi loc.
  • Buletinul listează doar primele ~50 de ţări, deci o ţară mai mică lipseşte din unele ediţii. Fără perioada, răspunsul dă ultima lună în care ţara chiar apare — nu o lună goală.
  • Sunt stocuri cumulate istoric, nu fluxuri: cifra nu spune ce s-a întâmplat în luna aia, ci câte societăţi existau la data buletinului.

La ce folosește

  • Analiza investiţiilor străine după ţara de origine a capitalului.
  • Un articol sau un raport despre capitalul dintr-o anumită ţară.
  • Compararea aportului mai multor ţări, în aceeaşi monedă.

Structura răspunsului

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

CâmpTipDescriere
cheie string Numele ţării, aşa cum îl scrie buletinul ONRC.
perioada string Luna la care sunt valorile, ca AAAA-LL.
indicatori[].indicator string Codul indicatorului.
indicatori[].denumire string Numele lui.
indicatori[].natura string Aici mereu stoc — clasamentul pe ţări e cumulat istoric, nu al lunii.
indicatori[].unitate string Unitatea: societăţi, mii lei, mii USD sau mii EUR.
indicatori[].valoare number Valoarea la luna respectivă.
indicatori[].valoare_an_anterior number|null Aceeaşi perioadă din anul precedent, dacă buletinul o publică.
indicatori[].variatie number|null Variaţia procentuală faţă de anul precedent, sau null.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/statistici/onrc/tari/Italia
{
    "data": {
        "cheie": "ITALIA",
        "perioada": "2026-07",
        "indicatori": [
            {
                "indicator": "cap_strain_mii_eur",
                "denumire": "Capital social străin subscris",
                "natura": "stoc",
                "unitate": "mii EUR",
                "valoare": 2846050.8,
                "valoare_an_anterior": null,
                "variatie": null
            }
        ]
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitNu există nimic pentru nume din cale.
422validareUn parametru nu a trecut validarea (perioada); detalii spune care şi de ce.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).
negasiteroareNu există serii de capital străin pentru ţara cerută, sau nu există date la perioada cerută.
perioada_invalidaeroarePerioada se scrie ca AAAA-LL.

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 nu a trecut validarea (perioada); detalii spune care şi de ce.",
        "detalii": {
            "nume": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}