Locations v1 / Ierarhie & dropdown-uri

UAT-urile unui județ

Lista paginată a UAT-urilor (comune/orașe/municipii) dintr-un județ, opțional
filtrată după tip. Județul e identificat prin cod_auto.

GET

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

Parametri de cale

NumeTipDescriereExemplu

judetobligatoriu string Codul judeţului, două litere (ex. CJ).

Parametri de interogare

NumeTipDescriereValori acceptate

tipopțional string | null Filtrează pe tipul UAT-ului. comunaorasmunicipiu

Cum se comportă

Bucureștiul apare cu sectoarele ca UAT-uri distincte.

La ce folosește

Al treilea nivel al selectorului de adresă în cascadă, după alegerea județului
Definirea ariilor de livrare / acoperire la nivel de comună, oraș sau municipiu
Targetare pe tip de UAT (ex. doar municipii) via tip

Structura răspunsului

CâmpTipDescriere

data[].cod_siruta integer Cheia publică a UAT-ului.

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

data[].tip string Tipul entității (cod brut; denumirile la /nomenclatoare/tipuri).

data[].populatie integer | null Populația (recensământ).

data[].suprafata_kmp number | null Suprafața, în km².

data[].resedinta string | null Numele localității de reședință a UAT-ului.

data[].nr_localitati integer Localități componente.

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.

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/judete/CJ/uat?per_pagina=20

{
    "data": [
        {
            "cod_siruta": 55473,
            "nume": "Aghireșu",
            "tip": "comuna",
            "populatie": 5691,
            "suprafata_kmp": 105.8006,
            "resedinta": "Aghireșu",
            "nr_localitati": 11,
            "nr_firme": 763,
            "nr_firme_functiune": 346
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 81,
            "pagini": 5
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/uat?tip=municipiu

{
    "data": [
        {
            "cod_siruta": 55357,
            "nume": "Câmpia Turzii",
            "tip": "municipiu",
            "populatie": 20590,
            "suprafata_kmp": 23.7772,
            "resedinta": "Câmpia Turzii",
            "nr_localitati": 1,
            "nr_firme": 4114,
            "nr_firme_functiune": 1824
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 5,
            "pagini": 1
        }
    }
}

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

{
    "data": [
        {
            "cod_siruta": 1151,
            "nume": "Abrud",
            "tip": "oras",
            "populatie": 4360,
            "suprafata_kmp": 39.5399,
            "resedinta": "Abrud",
            "nr_localitati": 4,
            "nr_firme": 938,
            "nr_firme_functiune": 345
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 78,
            "pagini": 4
        }
    }
}

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ă.
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": {
            "judet": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}