Locations v1 / Referință & business

Street company aggregates

Company aggregates for a single street: how many there are, how many active, which activities dominate. The finest level at which we have head offices positioned.

GET

https://oneapi.ro/api/locations/v1/strazi/{id}/firme/sumar

Path parameters

NameTypeDescriptionExample

idrequired string Internal identifier of the street — obtained from a street search.

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

Computed live (a street has tens to thousands of companies, so it is instant).
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/strazi/216508/firme/sumar

{
    "data": {
        "total": 26765,
        "in_functiune": 16883,
        "platitori_tva": 525,
        "top_caen": [
            {
                "cod": "5320",
                "denumire": "Alte activități poștale și de curier",
                "nr": 6283
            }
        ],
        "pe_stare": [
            {
                "stare": "funcțiune",
                "categorie": "activa",
                "nr": 16883
            }
        ],
        "pe_categorie": [
            {
                "categorie": "activa",
                "nr": 16883
            }
        ]
    },
    "meta": {
        "actualizat": {
            "firme": "2026-09-18T07: 16: 22+03: 00",
            "agregate": "2026-10-06T23: 13: 50+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/14612/firme/sumar

{
    "data": {
        "total": 15,
        "in_functiune": 5,
        "platitori_tva": 1,
        "top_caen": [
            {
                "cod": "5222",
                "denumire": "Activități de servicii anexe transportului pe apă",
                "nr": 2
            }
        ],
        "pe_stare": [
            {
                "stare": "radiată",
                "categorie": "radiata",
                "nr": 8
            }
        ],
        "pe_categorie": [
            {
                "categorie": "radiata",
                "nr": 8
            }
        ]
    },
    "meta": {
        "actualizat": {
            "firme": "2026-09-18T07: 16: 22+03: 00",
            "agregate": "2026-10-06T23: 13: 50+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/216508/firme/sumar?limita=5

{
    "data": {
        "total": 26765,
        "in_functiune": 16883,
        "platitori_tva": 525,
        "top_caen": [
            {
                "cod": "5320",
                "denumire": "Alte activități poștale și de curier",
                "nr": 6283
            }
        ],
        "pe_stare": [
            {
                "stare": "funcțiune",
                "categorie": "activa",
                "nr": 16883
            }
        ],
        "pe_categorie": [
            {
                "categorie": "activa",
                "nr": 16883
            }
        ]
    },
    "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 [{id}] 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": {
            "id": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}