Locations v1 / Ierarhie & dropdown-uri

Localitățile unui UAT

Lista paginată a localităților active dintr-un UAT (identificat prin cod_siruta),
ordonate după populație, opțional filtrate după tip.

GET

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

Parametri de cale

NumeTipDescriereExemplu

uatobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale.

Parametri de interogare

NumeTipDescriereValori acceptate

tipopțional string Filtrează pe tipul localității. ex. satex. resedinta_municipiuex. sector

Cum se comportă

227 din cele 13.755 de localităţi (1,65%) n-au cifră de populaţie — sate aproape depopulate, pentru care recensământul din 2021 n-a publicat o valoare (cea mai mică cifră publicată în ţară e 3). Nu e o legătură nefăcută: toate 227 există, cu geometrie şi cu identificator GeoNames. Cifrele de judeţ şi de UAT nu sunt afectate — vin din rândurile lor proprii de recensământ, nu din însumarea localităţilor. Cine însumează el localităţile pierde, la nivel naţional, 96 de persoane din 19.053.815.
Localitățile active ale UAT-ului, ordonate după populație descrescător (reședința iese prima).
Rândurile NU poartă contextul uat (îl știi din path) — acela apare doar în shortcut-ul pe județ.
tip e cod brut; denumirile lizibile vin din /nomenclatoare/tipuri. Filtrează cu ?tip=.

La ce folosește

Populezi al doilea dropdown „localitate" după ce userul a ales UAT-ul (comuna/orașul).
Enumeri satele componente ale unei comune pentru un formular administrativ.
Cu ?tip=sat, listezi doar satele componente, excluzând reședința.

Structura răspunsului

CâmpTipDescriere

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

data[].nume string Denumirea entității.

data[].tip string Cod brut al tipului de localitate (sat, reședință…); denumirile în /nomenclatoare/tipuri.

data[].populatie integer | null Populația localității — cheia de ordonare a listei.

data[].lat number | null Latitudine (WGS84) a punctului localității; poligoanele rămân premium.

data[].lng number | null Longitudine (WGS84).

data[].nr_firme integer Câte firme au fost vreodată înregistrate aici (egal cu total din ruta de sumar).

data[].nr_firme_functiune integer Câte există ACUM. ⚠️ Cifra de pus lângă nume: nr_firme include şi radiatele, care sunt 48,8% din total.

data[].uat.cod_siruta integer Codul SIRUTA al UAT-ului — chainable spre /uat/{cod}.

data[].uat.nume string Denumirea UAT-ului.

meta.paginare.pagina integer Pagina curentă.

meta.paginare.per_pagina integer Rezultate pe pagină.

meta.paginare.total integer Total rezultate.

meta.paginare.pagini integer Număr de pagini.

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/uat/55473/localitati?per_pagina=20

{
    "data": [
        {
            "cod_siruta": 55491,
            "nume": "Aghireșu-Fabrici",
            "tip": "sat",
            "populatie": 2622,
            "lat": 46.866878,
            "lng": 23.270057,
            "nr_firme": 281,
            "nr_firme_functiune": 137
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 11,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/54975/localitati

{
    "data": [
        {
            "cod_siruta": 54984,
            "nume": "Cluj-Napoca",
            "tip": "resedinta_municipiu",
            "populatie": 286598,
            "lat": 46.78,
            "lng": 23.559444444444,
            "nr_firme": 114118,
            "nr_firme_functiune": 50565
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/179132/localitati

{
    "data": [
        {
            "cod_siruta": 179169,
            "nume": "București Sectorul 3",
            "tip": "sector",
            "populatie": 374737,
            "lat": 44.43527778,
            "lng": 26.10277778,
            "nr_firme": 141268,
            "nr_firme_functiune": 58137
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 6,
            "pagini": 1
        }
    }
}

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ă.
422	validare	Un parametru nu a trecut validarea (`tip`); `detalii` spune care şi de ce.
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": "Un parametru nu a trecut validarea (tip); detalii spune care şi de ce.",
        "detalii": {
            "uat": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}