Locations v1 / Referință & business

Agregate firme pe UAT

Aceleaşi agregate de firme, dar pe unitatea administrativ-teritorială: comună, oraş sau municipiu, după codul SIRUTA.

GET

https://oneapi.ro/api/locations/v1/uat/{cod}/firme/sumar

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale (ex. 54975 pentru Cluj-Napoca).

Parametri de interogare

NumeTipDescriereValori acceptate

limitaopțional integer | null Câte activităţi întoarce top_caen. Implicit 5, maxim 25. O valoare în afara intervalului dă 422, nu e tăiată tăcut. 1 – 25

Cum se comportă

Agregatele sunt precalculate (locations:build-firme-sumar) — calculul live pe un județ durează ~9s. Câmpul actualizat spune când.
top_caen = activităţile după numărul de firme, 5 implicit, până la 25 cu limita; pe_stare = defalcarea pe stări.

La ce folosește

Profilul economic al zonei dintr-un singur call
Comparare de zone după număr de firme / sectoare dominante

Structura răspunsului

CâmpTipDescriere

data.total integer Numărul total de firme cu sediul în entitate.

data.in_functiune integer Câte dintre ele există ACUM (stare din categoria „activă"). ⚠️ 48,8% din firmele cu sediu legat sunt radiate — total le include, fiindcă numără tot ce a fost vreodată înregistrat aici.

data.platitori_tva integer Câte dintre ele sunt plătitoare de TVA.

data.top_caen[].cod string Codul CAEN al sectorului.

data.top_caen[].denumire string | null Denumirea sectorului.

data.top_caen[].nr integer Câte firme au acest CAEN principal.

data.pe_stare[].stare string | null Starea, aşa cum o scrie ONRC. Sunt întoarse TOATE stările prezente în zonă (mediana: 4 la localitate, 8 la UAT, 39 la judeţ), deci suma dă exact total. Fiecare rând poartă şi categorie.

data.pe_stare[].categorie string | null Categoria din clasificarea sursei.

data.pe_stare[].nr integer Câte firme sunt în această stare.

data.pe_categorie[].categorie string Defalcarea pe cele 7 categorii, derivată din pe_stare — vederea de ansamblu, când lista detaliată e prea lungă.

data.pe_categorie[].nr integer Câte firme sunt în categoria asta.

meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/uat/54975/firme/sumar

{
    "data": {
        "total": 114118,
        "in_functiune": 50565,
        "platitori_tva": 16184,
        "top_caen": [
            {
                "nr": 3711,
                "cod": "4932",
                "denumire": "Transporturi cu taxiuri"
            }
        ],
        "pe_stare": [
            {
                "nr": 53814,
                "stare": "radiată",
                "categorie": "radiata"
            }
        ],
        "pe_categorie": [
            {
                "categorie": "radiata",
                "nr": 53814
            }
        ]
    },
    "meta": {
        "actualizat": {
            "firme": "2026-09-18T07: 16: 22+03: 00",
            "agregate": "2026-10-06T23: 13: 50+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/155243/firme/sumar

{
    "data": {
        "total": 88695,
        "in_functiune": 37968,
        "platitori_tva": 10701,
        "top_caen": [
            {
                "nr": 3171,
                "cod": "4933",
                "denumire": "Transporturi terestre de pasageri cu vehicule cu șofer, pe bază de comandă"
            }
        ],
        "pe_stare": [
            {
                "nr": 42738,
                "stare": "radiată",
                "categorie": "radiata"
            }
        ],
        "pe_categorie": [
            {
                "categorie": "radiata",
                "nr": 42738
            }
        ]
    },
    "meta": {
        "actualizat": {
            "firme": "2026-09-18T07: 16: 22+03: 00",
            "agregate": "2026-10-06T23: 13: 50+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/95060/firme/sumar?limita=5

{
    "data": {
        "total": 87606,
        "in_functiune": 34135,
        "platitori_tva": 9061,
        "top_caen": [
            {
                "nr": 2647,
                "cod": "4933",
                "denumire": "Transporturi terestre de pasageri cu vehicule cu șofer, pe bază de comandă"
            }
        ],
        "pe_stare": [
            {
                "nr": 46447,
                "stare": "radiată",
                "categorie": "radiata"
            }
        ],
        "pe_categorie": [
            {
                "categorie": "radiata",
                "nr": 46447
            }
        ]
    },
    "meta": {
        "actualizat": {
            "firme": "2026-09-18T07: 16: 22+03: 00",
            "agregate": "2026-10-06T23: 13: 50+03: 00"
        }
    }
}

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	Entitatea [{cod}] nu există.
422	validare	`limita` în afara intervalului 1-25, sau orice alt parametru în afară de `lang` şi `limita`.
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": "limita în afara intervalului 1-25, sau orice alt parametru în afară de lang şi limita.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}