Locations v1 / Referință & business

Agregate firme pe stradă

Agregatele de firme de pe o singură stradă: câte sunt, câte în funcţiune, ce activităţi domină. Cel mai fin nivel la care avem sedii poziţionate.

GET

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

Parametri de cale

NumeTipDescriereExemplu

idobligatoriu string Identificatorul intern al străzii — se obţine din căutarea de străzi.

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ă

Se calculează live (o stradă are zeci–mii de firme, deci e instant).
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/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"
        }
    }
}

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 [{id}] 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": {
            "id": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}