Business v1 / Firme

Sucursale

Sucursalele și unitățile firmei (inclusiv cele din străinătate), cu tip, EUID, cod fiscal și țară.

GET

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

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ă

Două surse, marcate în sursa. Sucursalele româneşti (onrc_denumire) sunt înmatriculate la ONRC ca firme separate, cu CUI propriu şi fără câmp de legătură la firma-mamă; legătura se face după denumire („BANCA TRANSILVANIA SA CLUJ SUCURSALA BUZAU" → „BANCA TRANSILVANIA SA"). Din 12.314 sucursale din registru, 6.079 sunt legate; restul au un nume care nu mai corespunde firmei-mamă (redenumită ori radiată) ori sunt ambigue între firme omonime, şi rămân nelegate intenţionat. Sucursalele din alte state UE (onrc_ue) vin din fişierul ONRC dedicat.
Majoritatea sucursalelor româneşti din registru sunt radiate (8.224 din 12.314) — lista le include, ordonate după cele active; stare le deosebeşte.
Punctele de lucru (unităţi fără CUI propriu) nu sunt aici — pentru locaţiile autorizate ale firmei vezi /firme/{cui}/puncte-lucru.

La ce folosește

Reţeaua teritorială a unei bănci ori a unui asigurător, cu starea fiecărei sucursale.
Aflarea dacă un partener are prezenţă în alt judeţ sau în altă ţară UE.
Legarea unui CUI de sucursală de firma care răspunde pentru ea.

Structura răspunsului

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

CâmpTipDescriere

nr_sucursale integer Numărul de sucursale găsite, active şi radiate.

sucursale[].tip string | null Tipul unităţii.

sucursale[].denumire string | null Denumirea sucursalei, din registru.

sucursale[].euid string | null Identificatorul european unic al sucursalei, unde există.

sucursale[].cod_fiscal string | null Codul fiscal propriu al sucursalei; la cele din UE, cum îl dă ONRC (uneori 0).

sucursale[].tara string | null Ţara în care e sucursala.

sucursale[].judet string | null Judeţul sediului sucursalei, la cele româneşti.

sucursale[].localitate string | null Localitatea sediului sucursalei, la cele româneşti.

sucursale[].stare string | null Starea sucursalei româneşti, ca obiect (cod, denumire, categorie) — aceeaşi formă ca la orice firmă; null la cele din UE. ⚠️ Până pe 4 oct 2026 câmpul întorcea CATEGORIA sub acelaşi nume sub care alte rute întorceau denumirea.

sucursale[].sursa string onrc_denumire — sucursală românească legată după denumire; onrc_ue — sucursală din alt stat UE, declarată ca atare de ONRC.

sucursale[].potrivire string | null La onrc_denumire: exact — o singură firmă poartă numele; probabil — firme omonime, aleasă după oraşul sediului ori ca singura nerădiată. null la onrc_ue.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/5022670/sucursale

{
    "data": {
        "nr_sucursale": 61,
        "sucursale": [
            {
                "tip": "Sucursală",
                "denumire": "BANCA TRANSILVANIA SA CLUJ-NAPOCA SUCURSALA ALBA IULIA",
                "euid": "ROONRC.J2000000460017",
                "cod_fiscal": "13589324",
                "tara": "România",
                "judet": "Alba",
                "localitate": "Municipiul Alba Iulia",
                "stare": {
                    "cod": "1048",
                    "denumire": "funcțiune",
                    "categorie": "activa"
                },
                "sursa": "onrc_denumire",
                "potrivire": "exact"
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/422757/sucursale

{
    "data": {
        "nr_sucursale": 13,
        "sucursale": [
            {
                "tip": "Sucursală",
                "denumire": "INTERNATIONAL CONSULTING AGENCY SRL SUCURSALA LINZ",
                "euid": null,
                "cod_fiscal": "0",
                "tara": "Austria",
                "judet": null,
                "localitate": null,
                "stare": null,
                "sursa": "onrc_ue",
                "potrivire": null
            }
        ]
    }
}

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

{
    "data": {
        "nr_sucursale": 0,
        "sucursale": []
    }
}

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