Locations v1 / Referință & business

Administrative unit company aggregates

The same company aggregates, but for one administrative-territorial unit: commune, town or city, by SIRUTA code.

GET

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

Path parameters

NameTypeDescriptionExample

codrequired string SIRUTA code of the administrative-territorial unit (e.g. 54975 for Cluj-Napoca).

Query parameters

NameTypeDescriptionAccepted values

limitaoptional integer | null How many activities top_caen returns. Default 5, maximum 25. A value outside the range returns 422 rather than being silently clamped. 1 – 25

How it behaves

The aggregates are precomputed (locations:build-firme-sumar) — computing them live for a county takes about 9 seconds. The actualizat field says when.
top_caen = activities by company count, 5 by default, up to 25 with limita; pe_stare = the breakdown by status.

What it is for

The economic profile of an area in a single call
Comparing areas by company count or dominant sectors

Response structure

FieldTypeDescription

data.total integer The total number of companies registered in the entity.

data.in_functiune integer How many of them exist NOW (state in the „active" category). ⚠️ 48.8% of companies with a linked registered office are struck off — total includes them, because it counts everything ever registered here.

data.platitori_tva integer How many of them are VAT-registered.

data.top_caen[].cod string The NACE (CAEN) code of the sector.

data.top_caen[].denumire string | null The name of the sector.

data.top_caen[].nr integer How many companies have this as their main NACE code.

data.pe_stare[].stare string | null The status as ONRC writes it. ALL statuses present in the area are returned (median: 4 for a locality, 8 for a UAT, 39 for a county), so the rows add up to total exactly. Each row also carries its categorie.

data.pe_stare[].categorie string | null Category in the source classification.

data.pe_stare[].nr integer How many companies are in this status.

data.pe_categorie[].categorie string The breakdown across the 7 categories, derived from pe_stare — the overview, for when the detailed list is too long.

data.pe_categorie[].nr integer How many companies are in this category.

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

Response examples

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

Error codes

Code	Slug	When it occurs
401	neautentificat	Token missing, invalid, expired or revoked.
403	feature_indisponibil	The current plan does not include the feature the route depends on.
404	negasit	The entity [{cod}] does not exist.
422	validare	`limita` outside the range 1-25, or any parameter other than `lang` and `limita`.
429	cota_depasita	The plan's monthly quota has been exceeded (see `Retry-After`).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "limita outside the range 1-25, or any parameter other than lang and limita.",
        "detalii": {
            "cod": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}