Locations v1 / Demografie

Demografia unui UAT

Populația (total + defalcare M/F) și densitatea (locuitori/km²) ale unui UAT (cod_siruta).

GET

https://oneapi.ro/api/locations/v1/uat/{cod}/demografie

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale (ex. 54975 pentru Cluj-Napoca).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Populația oficială RPL2021 (total + M/F) + densitatea (locuitori/km²).

La ce folosește

Afișarea populației și densității unei comune/oraș pe pagina de detaliu UAT.
Segmentare urban/rural după densitate pentru tarifare sau reguli de livrare.
Ponderarea unor indicatori pe cap de locuitor la nivel de UAT.

Structura răspunsului

CâmpTipDescriere

data.cod_siruta integer Codul SIRUTA (cheia publică a entității).

data.nume string Denumirea entității.

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ă.

data.populatie.sursa string | null Sursa populației (ex. RPL2021).

data.suprafata_kmp number | null Suprafața, î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/uat/54975/demografie

{
    "data": {
        "cod_siruta": 54975,
        "nume": "Cluj-Napoca",
        "populatie": {
            "total": 286598,
            "masculin": 134768,
            "feminin": 151830,
            "an": 2021,
            "sursa": "RPL2021"
        },
        "suprafata_kmp": 174.8759,
        "densitate": 1638.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/uat/155243/demografie

{
    "data": {
        "cod_siruta": 155243,
        "nume": "Timișoara",
        "populatie": {
            "total": 250849,
            "masculin": 116874,
            "feminin": 133975,
            "an": 2021,
            "sursa": "RPL2021"
        },
        "suprafata_kmp": 129.2217,
        "densitate": 1941.2
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/1071/demografie

{
    "data": {
        "cod_siruta": 1071,
        "nume": "Ciugud",
        "populatie": {
            "total": 3285,
            "masculin": 1609,
            "feminin": 1676,
            "an": 2021,
            "sursa": "RPL2021"
        },
        "suprafata_kmp": 43.9155,
        "densitate": 74.8
    },
    "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	UAT-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": "UAT-ul nu există."
    }
}