oneapi
Autentificare
Business v1 / Firme

Firmă după LEI

Găsește firma după codul LEI (Legal Entity Identifier) și întoarce profilul ei.

GET
https://oneapi.ro/api/business/v1/firme/dupa-lei/{lei}

Parametri de cale

NumeTipDescriereExemplu
leiobligatoriu string Codul LEI, 20 de caractere alfanumerice.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

  • Găseşte firma după codul LEI (Legal Entity Identifier) şi întoarce profilul.

La ce folosește

  • Trecerea de la un set de date financiare internaţional la firma din România.
  • Reconcilierea unui portofoliu cheiat pe LEI cu registrul naţional.
  • Verificarea faptului că LEI-ul dintr-o raportare corespunde firmei aşteptate.

Structura răspunsului

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

CâmpTipDescriere
cui integer Codul fiscal.
denumire string | null Denumirea.
cod_inmatriculare string | null Numărul de ordine în registrul comerţului (J…).
euid string | null Identificatorul european unic al firmei.
forma_juridica string | null Forma juridică (SRL, SA, PFA…).
stare string | null Starea firmei, ca obiect: denumire e textul brut din ONRC (107 valori distincte folosite), categorie e clasificarea noastră în 7 cutii — activa, suspendata, dizolvata, lichidare, radiata, insolventa, alta — pe care o foloseşti ca să filtrezi sau să grupezi. cod e codul ONRC al stării.
data_inmatriculare string | null Data înmatriculării la registrul comerţului.
sediu.raw[] string | integer Adresa sediului aşa cum e la sursă, câmp cu câmp; cheile goale lipsesc.
sediu.rezolvat.localitate_id integer Id-ul intern al localităţii în Locations.
sediu.rezolvat.localitate string Localitatea.
sediu.rezolvat.cod_siruta integer | null Codul SIRUTA al localităţii — chainable spre /locations/v1.
sediu.rezolvat.uat string | null Unitatea administrativ-teritorială.
sediu.rezolvat.judet string | null Judeţul.
sediu.rezolvat.regiune string | null Regiunea de dezvoltare.
sediu.rezolvat.cod_nuts string | null Codul NUTS al unităţii teritoriale.
sediu.rezolvat.populatie integer | null Populaţia localităţii (recensământ).
sediu.rezolvat.strada_id integer | null Id-ul străzii în Locations — chainable spre /locations/v1/strazi/{id}.
sediu.rezolvat.strada string | null Strada.
sediu.rezolvat.potrivire[] string Cât de sigură e legarea la nomenclator, pe localitate şi pe stradă.
sediu.rezolvat.coordonate.lat number Latitudinea, în grade zecimale (WGS 84).
sediu.rezolvat.coordonate.lng number Longitudinea, în grade zecimale (WGS 84).
sediu.rezolvat.coordonate.precizie string Vezi precizie de la /firme/{cui}/locatie: numar, numar_aproximativ, strada ori localitate. ⚠️ Nu desena ac decât pe primele două.
caen_principal.cod string Codul CAEN principal.
caen_principal.denumire string | null Denumirea activităţii principale.
caen_principal.versiune string Revizia CAEN în care e exprimat codul.
fiscal.platitor_tva boolean Plătitoare de TVA la ultima sincronizare.
fiscal.tva_la_incasare boolean Aplică TVA la încasare.
fiscal.split_tva boolean Aplică split TVA.
fiscal.inactiv_fiscal boolean Declarată inactivă fiscal.
fiscal.e_factura boolean Înrolată în e-Factura.
fiscal.radiata boolean Firma e radiată.
prezente[] mixed În ce seturi de date mai apare firma (financiar, achiziţii, registre…).

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/dupa-lei/097900BEKK0000002827
{
    "data": {
        "cui": 9515361,
        "denumire": "GRAIN EXPRESS SRL",
        "cod_inmatriculare": "J05/773/1997",
        "euid": "ROONRC.J05/773/1997",
        "forma_juridica": "SRL",
        "stare": {
            "cod": "1048",
            "denumire": "funcțiune",
            "categorie": "activa"
        },
        "data_inmatriculare": "1997-06-10",
        "sediu": {
            "raw": {
                "judet": "Bihor",
                "localitate": "Municipiul Oradea",
                "strada": "Str. NUFĂRULUI",
                "numar": "29",
                "bloc": "D127",
                "apartament": "2",
                "sector": 0
            },
            "rezolvat": {
                "localitate_id": 2095,
                "localitate": "Oradea",
                "cod_siruta": 26573,
                "uat": "Oradea",
                "judet": "Bihor",
                "regiune": "Nord-Vest",
                "cod_nuts": "RO111",
                "populatie": 183105,
                "strada_id": 468,
                "strada": "Nufărului",
                "potrivire": {
                    "loc": "exact",
                    "str": "exact"
                },
                "coordonate": {
                    "lat": 47.031708,
                    "lng": 21.951862,
                    "precizie": "strada"
                }
            }
        },
        "caen_principal": {
            "cod": "4619",
            "denumire": "Intermedieri în comerțul cu produse diverse",
            "versiune": "CAEN Rev.2"
        },
        "fiscal": {
            "platitor_tva": true,
            "tva_la_incasare": false,
            "split_tva": false,
            "inactiv_fiscal": false,
            "e_factura": true,
            "radiata": false
        },
        "prezente": {
            "nr_persoane": 1,
            "ani_financiar": [
                2008,
                2009,
                2010,
                2011,
                2012,
                2013,
                2014,
                2015,
                2016,
                2017,
                2018,
                2019,
                2020,
                2021,
                2022,
                2023,
                2024,
                2025
            ],
            "nr_achizitii": 26,
            "registre": [
                "afir_pndr",
                "ansvsa",
                "contribuabili",
                "dgsante",
                "mcpds_sponsorizari",
                "ted_ro"
            ]
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitNicio firmă cu codul LEI [{lei}].
422validareRuta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.",
        "detalii": {
            "lei": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}