Locations v1 / Ierarhie & dropdown-uri

Listă județe

Toate cele 42 de județe sau, când e apelat ca /regiuni/{regiune}/judete, doar
județele regiunii date. Fiecare item are reședința + numărul de UAT-uri.

GET

https://oneapi.ro/api/locations/v1/judete

Parametri de interogare

Ruta nu acceptă parametri de interogare.

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.
Toate județele, alfabetic. Rândul de pornire pentru orice cascadă de dropdown-uri.
cod e indicativul auto (CJ, IS, B) — cea mai comodă valoare pentru un <option>.

La ce folosește

Popularea dropdown-ului de județ în formulare de checkout / înregistrare
Primul pas al unui selector de adresă în cascadă județ → UAT → localitate
Listă de referință pre-încărcată pentru validarea unui indicativ auto introdus de utilizator

Structura răspunsului

CâmpTipDescriere

data[].cod string Indicativ auto: CJ, IS, B…

data[].cod_siruta integer Codul SIRUTA oficial (secundar).

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

data[].resedinta string | null Reședința de județ.

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

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

data[].nr_uat integer Câte UAT-uri are județul.

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.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

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

{
    "data": [
        {
            "cod": "AB",
            "cod_siruta": 10,
            "nume": "Alba",
            "resedinta": "Alba Iulia",
            "populatie": 325941,
            "suprafata_kmp": 6256.544,
            "nr_uat": 78
        }
    ],
    "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	Regiunea [{regiune}] nu există.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat."
    }
}