Locations v1 / Ierarhie & dropdown-uri

Detaliu județ

Un județ după cod_auto (CJ/IF/B), cu regiunea părinte, reședința (chainable) și
numărul de UAT-uri + localități.

GET

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

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul judeţului, două litere (ex. CJ). Bucureştiul e B.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Când resedinta e null, resedinta_nota spune de ce. Sunt trei cazuri, toate particularităţi reale ale organizării administrative, nu goluri de date: judeţul şi municipiul Bucureşti (care e el însuşi reşedinţă, iar la nivel de localitate are doar cele şase sectoare) şi judeţul Ilfov (a cărui reşedinţă, Bucureştiul, e în afara lui).
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.
{cod} e indicativul auto, case-insensitive (cj = CJ); Bucureștiul e B.
populatie și suprafata_kmp pot fi null când agregatul lipsește.

La ce folosește

Afișarea unei pagini de județ (reședință, regiune, nr. localități) într-un portal
Rezolvarea unui indicativ auto la județul complet pentru etichete și afișare
Navigare drill-down din județ către UAT-uri / localități

Structura răspunsului

CâmpTipDescriere

data.cod string Codul entității (cheia publică a nivelului).

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

data.cod_nuts string | null Codul NUTS-3 al județului — se unește direct cu seturile Eurostat.

data.geoname_id integer | null Id-ul GeoNames al județului (punte externă, nu cheie de-a noastră).

data.wikidata_qid string | null QID-ul Wikidata al județului.

data.nume string Denumirea entității.

data.regiune object Regiunea din care face parte (link în sus).

data.regiune.cod string Codul NUTS-2 al regiunii.

data.regiune.nume string Numele regiunii.

data.resedinta object Reședința, chainable spre /localitati/{cod}.

data.resedinta.nume string Denumirea localității de reședință.

data.resedinta.cod_siruta integer Codul SIRUTA al reședinței — chainable spre /localitati/{cod}.

data.resedinta_nota string | null De ce nu există reşedinţă. Apare doar când resedinta e null.

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_localitati integer Localități active în județ.

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

Exemple de răspuns

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

{
    "data": {
        "cod": "CJ",
        "cod_siruta": 127,
        "cod_nuts": "RO113",
        "geoname_id": 681291,
        "wikidata_qid": "Q182624",
        "nume": "Cluj",
        "regiune": {
            "cod": "RO11",
            "nume": "Nord-Vest"
        },
        "resedinta": {
            "nume": "Cluj-Napoca",
            "cod_siruta": 54984
        },
        "resedinta_nota": null,
        "populatie": 679141,
        "suprafata_kmp": 6666.8818,
        "nr_uat": 81,
        "nr_localitati": 434
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

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

{
    "data": {
        "cod": "AB",
        "cod_siruta": 10,
        "cod_nuts": "RO121",
        "geoname_id": 686581,
        "wikidata_qid": "Q45868",
        "nume": "Alba",
        "regiune": {
            "cod": "RO12",
            "nume": "Centru"
        },
        "resedinta": {
            "nume": "Alba Iulia",
            "cod_siruta": 1026
        },
        "resedinta_nota": null,
        "populatie": 325941,
        "suprafata_kmp": 6256.544,
        "nr_uat": 78,
        "nr_localitati": 716
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        }
    }
}

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

{
    "data": {
        "cod": "B",
        "cod_siruta": 403,
        "cod_nuts": "RO321",
        "geoname_id": null,
        "wikidata_qid": null,
        "nume": "București",
        "regiune": {
            "cod": "RO32",
            "nume": "București-Ilfov"
        },
        "resedinta": null,
        "resedinta_nota": "Municipiul Bucureşti este el însuşi reşedinţă. La nivel de localitate are doar cele şase sectoare, niciunul dintre ele nefiind reşedinţă de judeţ.",
        "populatie": 1716961,
        "suprafata_kmp": 238.9761,
        "nr_uat": 1,
        "nr_localitati": 6
    },
    "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	Județ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": "Județul nu există."
    }
}