Business v1 / Statistici

Company statistics

The distribution of companies along one dimension: ?dimensiune=forma|stare|judet|caen (forma by default). For caen it returns the top 20.

GET

https://oneapi.ro/api/business/v1/statistici/firme

Query parameters

NameTypeDescriptionAccepted values

dimensiuneoptional string | null forma, stare, judet or caen. e.g. judete.g. formae.g. stare

How it behaves

The distribution of companies over a dimension: ?dimensiune=forma|stare|judet|caen (default forma). For caen it returns the top 20. The aggregations are computed over ~3.9M companies and cached.

What it is for

A summary panel on the structure of the business environment.
Comparing counties by company count or activity profile.
The aggregate context in which you place a single company's figures.

Response structure

All fields below live inside data.

FieldTypeDescription

dimensiune string How many companies the register holds in total.

distributie[].judet string The county.

distributie[].cod_auto string The county car-plate code.

distributie[].nr_firme integer The number of companies.

Response examples

GEThttps://oneapi.ro/api/business/v1/statistici/firme?dimensiune=judet

{
    "data": {
        "dimensiune": "judet",
        "distributie": [
            {
                "judet": "București",
                "cod_auto": "B",
                "nr_firme": 725317
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/statistici/firme?dimensiune=forma

{
    "data": {
        "dimensiune": "forma",
        "distributie": [
            {
                "forma": "SRL",
                "este_persoana_fizica": false,
                "nr_firme": 2666704
            }
        ]
    }
}

GEThttps://oneapi.ro/api/business/v1/statistici/firme?dimensiune=stare

{
    "data": {
        "dimensiune": "stare",
        "distributie": [
            {
                "stare": "radiată",
                "categorie": "radiata",
                "nr_firme": 1908588
            }
        ]
    }
}

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.
422	validare	An undeclared parameter or a value that fails validation (`dimensiune`). The offending field is in `detalii`.
422	dimensiune_invalida	Valid dimensions: forma, stare, judet, caen.
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": "An undeclared parameter or a value that fails validation (dimensiune). The offending field is in detalii.",
        "detalii": {
            "dimensiune": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}