oneapiUnități administrative
Localități, orașe, comune, județe și regiuni, cu ierarhia administrativă completă, coduri oficiale și coordonate. Setul de referință pentru orice câmp de adresă din aplicația ta.
{
"data": [
{ "nume": "Cluj-Napoca", "cod": 54975, "judet": "CJ", "tip": "municipiu" },
{ "nume": "Cluj", "cod": 54932, "judet": "CJ", "tip": "județ" },
{ "nume": "Voluntari", "cod": 104630, "judet": "IF", "tip": "oraș" }
],
"meta": {
"actualizat": {
"administrativ": "2026-07-23T04:00:00Z",
"populatie": "2026-07-23T04:00:00Z"
}
}
}
- Localități
- 13.755
- Rute API
- 89
- Versiune
- v1 · stabil
- Frecvență import
- zilnic
- Coduri poștale
- 54.571
- Licență
- date publice
Ce primești în fiecare înregistrare.
Câmpurile de mai jos sunt garantate în v1. Adăugăm câmpuri fără să schimbăm versiunea, deci clientul tău trebuie să ignore ce nu cunoaște.
Ce poți interoga.
/api/locations/v1/localitati
Localități
Listă și căutare full-text, filtrabilă după județ și tip.
/api/locations/v1/localitati/{cod}
O localitate
O singură localitate, cu ierarhia completă la cerere.
/api/locations/v1/judete
Județe
Toate județele, cu numărul de localități din fiecare.
/api/locations/v1/judete/{cod}/localitati
Localitățile unui județ
Localitățile dintr-un județ.
/api/locations/v1/regiuni
Regiuni
Regiunile de dezvoltare și județele componente.
/api/locations/v1/cauta
Căutare unificată
Căutare unificată peste toate tipurile de unități.
Pentru ce se folosește, concret.
Câmp de adresă
Sugestii pe măsură ce userul tastează, filtrate pe județ dacă l-a ales deja.
# debounce 300 ms în client GET /api/locations/v1/localitati ?q=volun&judet=IF&limita=8
Adrese la checkout
Verifici că perechea localitate–județ chiar există înainte să salvezi comanda.
# 404 dacă perechea nu e validă GET /api/locations/v1/localitati/104630 ?include=judet
Grupare geografică
Agregi comenzile pe județ sau regiune folosind coduri stabile, nu string-uri scrise de mână.
# ierarhia pentru rollup GET /api/locations/v1/regiuni ?include=judete
De unde vin datele și ce poți face cu ele.
Sursă și actualizare
Datele provin din nomenclatorul administrativ oficial și din surse publice de recensământ. Le normalizăm: diacritice consistente, tipuri de unități mapate pe un enum fix, ierarhie completată acolo unde sursa o lasă implicită.
Setul e static — se schimbă doar când apare o modificare administrativă reală (reîncadrare, redenumire, comună nouă). Verificăm sursa lunar și publicăm modificările în changelog. Fiecare răspuns conține actualizat, iar header-ul x-data-updated îți spune vechimea setului.
Limite și licență
Codurile oficiale sunt stabile: nu le refolosim și nu le reatribuim. O localitate desființată rămâne în set cu stare: inactiva, ca integrările vechi să nu se rupă.
Datele sunt publice și le poți folosi comercial în produsul tău, pe orice plan inclusiv Free. Nu poți redistribui setul brut ca produs concurent. Coordonatele sunt aproximative, la nivel de centroid administrativ — nu sunt geocodare de adresă exactă.