Locations v1 / Demografie

Statistici de județ

Agregate ale unui județ: număr de UAT-uri și localități, populație (total + M/F),
suprafață și densitate. Județul e identificat prin cod_auto.

GET

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

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul judeţului, două litere (ex. CJ). Bucureştiul e B.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Număr de UAT-uri și localități, populație (total + M/F), suprafață și densitate.

La ce folosește

Fișă de județ într-un portal: nr UAT/localități, populație și densitate într-un singur call.
Comparație între județe pentru alocare de resurse sau planificare logistică.
Header de raport regional cu agregatele județului.

Structura răspunsului

CâmpTipDescriere

data.cod string Codul entității (cheia publică a nivelului).

data.nume string Denumirea entității.

data.nr_uat integer Numărul de UAT-uri din județ.

data.nr_localitati integer Numărul total de localități din județ.

data.populatie object Obiect cu total + defalcare masculin/feminin + anul sursei.

data.populatie.total integer | null Populația totală.

data.populatie.masculin integer | null Populația masculină.

data.populatie.feminin integer | null Populația feminină.

data.populatie.an integer | null Anul recensământului sursă (RPL2021).

data.suprafata_kmp number | null Suprafața județului în km².

data.densitate number | null Locuitori pe km² (populație / suprafață).

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

Exemple de răspuns

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

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	Județul nu există.
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": "negasit",
        "mesaj": "Județul nu există."
    }
}