oneapi
Autentificare
Business v1 / Firme

Firme dintr-un UAT

Firmele cu sediul într-o unitate administrativ-teritorială, după codul SIRUTA al UAT-ului — comună, oraş sau municipiu, nu doar localitatea de reşedinţă.

GET
https://oneapi.ro/api/business/v1/uat/{uat}/firme

Parametri de cale

NumeTipDescriereExemplu
uatobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale.

Parametri de interogare

NumeTipDescriereValori acceptate
sortareopțional string | null Ordinea: denumire (implicit), cifra_afaceri, profit, salariati (descrescător, pe ultimul bilanţ depus), data_inmatriculare (cele mai noi întâi). relevantadenumirecifra_afaceriprofitsalariatidata_inmatriculare

Cum se comportă

  • Firmele cu sediul într-un UAT (comună/oraş/municipiu), prin filtrul de UAT din Locations. Mai fin decât judeţul, mai larg decât localitatea.
  • Cu sortare=cifra_afaceri, profit ori salariati, lista devine un clasament pe ultimul bilanţ depus al fiecărei firme (anul e în financiar.an, deci poate diferi între firme) şi cuprinde doar firmele care au bilanţ — meta.paginare.total scade în consecinţă. Pentru un clasament pe un singur an: /firme/top.

La ce folosește

  • Raportări pe unitatea administrativ-teritorială, aşa cum le cer instituţiile.
  • Analize de dezvoltare locală, la nivelul comunei sau al oraşului.
  • Corelarea firmelor cu bugetele şi indicatorii publicaţi pe UAT.

Structura răspunsului

CâmpTipDescriere
data[].cui integer Codul fiscal.
data[].denumire string Denumirea.
data[].cod_inmatriculare string Numărul de ordine în registrul comerţului (J…).
data[].forma_juridica string Forma juridică (SRL, SA, PFA…).
data[].stare string 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[].data_inmatriculare string Data înmatriculării la registrul comerţului.
data[].sediu.judet string Judeţul sediului social.
data[].sediu.localitate string Localitatea sediului social.
data[].sediu.cod_siruta integer Codul SIRUTA al localităţii — chainable spre /locations/v1.
data[].caen_principal.cod string Codul CAEN principal.
data[].caen_principal.denumire string Denumirea activităţii principale.
data[].fiscal.tva boolean Plătitoare de TVA.
data[].fiscal.inactiv boolean Declarată inactivă fiscal.
data[].fiscal.e_factura boolean Înrolată în e-Factura.
data[].financiar object | null Ultimul bilanţ depus (an, cifră de afaceri, profit net, salariaţi); null la firmele fără bilanţ — PFA-uri, firme noi —, nu zero.
data[].financiar.an integer Anul bilanţului.
data[].financiar.cifra_afaceri number | null Cifra de afaceri netă, în lei.
data[].financiar.profit_net number | null Profitul net, în lei; negativ = pierdere.
data[].financiar.salariati integer | null Numărul mediu de salariaţi.
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/uat/27383/firme
{
    "data": [
        {
            "cui": 34688240,
            "denumire": "ABRA AGROSUIN SRL",
            "cod_inmatriculare": "J5/993/2015",
            "forma_juridica": "SRL",
            "stare": {
                "cod": "2129",
                "denumire": "Instituire ipotecă mobiliară asupra părților sociale/acțiunilor",
                "categorie": "alta"
            },
            "data_inmatriculare": "2015-06-23",
            "sediu": {
                "judet": "Bihor",
                "localitate": "Tăut",
                "cod_siruta": 27427
            },
            "caen_principal": {
                "cod": "0142",
                "denumire": "Creșterea altor bovine"
            },
            "fiscal": {
                "tva": true,
                "inactiv": false,
                "e_factura": false
            },
            "financiar": {
                "an": 2025,
                "cifra_afaceri": 799657,
                "profit_net": 15879,
                "salariati": 1
            }
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 460,
            "pagini": 23
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitUAT-ul [{uat}] nu există. Se dă prin codul SIRUTA ori prin nume.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (pagina, per_pagina, sortare). Câmpul vinovat e în detalii.
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 ori o valoare care nu trece validarea (pagina, per_pagina, sortare). Câmpul vinovat e în detalii.",
        "detalii": {
            "uat": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}