Locations v1 / Demografie

County statistics

A county's aggregates: number of administrative units and localities, population (total + male/female), area and density. The county is identified by its registration prefix.

GET

https://oneapi.ro/api/locations/v1/judete/{cod}/statistici

Path parameters

NameTypeDescriptionExample

codrequired string County code, two letters (e.g. CJ). Bucharest is B.

Query parameters

This route accepts no query parameters.

How it behaves

The number of units and localities, population (total + male/female), area and density.

What it is for

A county record in a portal: number of units and localities, population and density in a single call.
Comparing counties for resource allocation or logistics planning.
A regional report header carrying the county's aggregates.

Response structure

FieldTypeDescription

data.cod string The entity code (the public key of that level).

data.nume string The name of the entity.

data.nr_uat integer The number of administrative units in the county.

data.nr_localitati integer The total number of localities in the county.

data.populatie object An object with the total plus the male/female breakdown and the source year.

data.populatie.total integer | null Total population.

data.populatie.masculin integer | null Male population.

data.populatie.feminin integer | null Female population.

data.populatie.an integer | null The year of the source census (RPL2021).

data.suprafata_kmp number | null The county's area in km².

data.densitate number | null Inhabitants per km² (population / area).

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

Response examples

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/statistici

{
    "data": {
        "cod": "CJ",
        "nume": "Cluj",
        "nr_uat": 81,
        "nr_localitati": 434,
        "populatie": {
            "total": 679141,
            "masculin": 327314,
            "feminin": 351827,
            "an": 2021
        },
        "suprafata_kmp": 6666.8818,
        "densitate": 101.9
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/AB/statistici

{
    "data": {
        "cod": "AB",
        "nume": "Alba",
        "nr_uat": 78,
        "nr_localitati": 716,
        "populatie": {
            "total": 325941,
            "masculin": 160287,
            "feminin": 165654,
            "an": 2021
        },
        "suprafata_kmp": 6256.544,
        "densitate": 52.1
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/B/statistici

{
    "data": {
        "cod": "B",
        "nume": "București",
        "nr_uat": 1,
        "nr_localitati": 6,
        "populatie": {
            "total": 1716961,
            "masculin": 790749,
            "feminin": 926212,
            "an": 2021
        },
        "suprafata_kmp": 238.9761,
        "densitate": 7184.7
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+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 county does not exist.
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": "negasit",
        "mesaj": "The county does not exist."
    }
}