Locations v1 / Ierarhie & dropdown-uri

Listă regiuni

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/regiuni/{regiune}/judete

Parametri de cale

NumeTipDescriereExemplu

regiuneobligatoriu string Codul NUTS 2 al regiunii de dezvoltare.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Aceeași formă ca /judete, dar filtrat la o regiune. {regiune} e codul NUTS-2 (RO11…), case-insensitive.
Județele vin alfabetic; regiunea nu are cod_siruta, cheia ei e cod.

La ce folosește

Al doilea nivel al unui selector de adresă în cascadă, după alegerea regiunii
Popularea unui dropdown de județ deja restrâns la regiunea selectată
Agregare comercială / logistică pe regiuni de dezvoltare

Structura răspunsului

CâmpTipDescriere

data[].cod string Indicativ auto (CJ, IF, B) — cheia publică a județului.

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

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 Numărul de UAT-uri.

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/regiuni/RO11/judete

{
    "data": [
        {
            "cod": "BH",
            "cod_siruta": 56,
            "nume": "Bihor",
            "resedinta": "Oradea",
            "populatie": 551297,
            "suprafata_kmp": 7537.6551,
            "nr_uat": 101
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

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

{
    "data": [
        {
            "cod": "B",
            "cod_siruta": 403,
            "nume": "București",
            "resedinta": null,
            "populatie": 1716961,
            "suprafata_kmp": 238.9761,
            "nr_uat": 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/regiuni/RO42/judete

{
    "data": [
        {
            "cod": "AR",
            "cod_siruta": 29,
            "nume": "Arad",
            "resedinta": "Arad",
            "populatie": 410143,
            "suprafata_kmp": 7743.4823,
            "nr_uat": 78
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

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

{
    "data": [
        {
            "cod": "BR",
            "cod_siruta": 92,
            "nume": "Brăila",
            "resedinta": "Brăila",
            "populatie": 281452,
            "suprafata_kmp": 4764.9107,
            "nr_uat": 44
        }
    ],
    "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 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": "Regiunea nu există."
    }
}