oneapi
Autentificare
Locations v1 / Ierarhie & dropdown-uri

Localitățile unui județ (shortcut)

⭐ Toate localitățile active dintr-un județ direct, sărind nivelul UAT. Fiecare item
poartă contextul UAT-ului. Județul e identificat prin cod_auto. Paginat + filtru tip.

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

Parametri de cale

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

Parametri de interogare

NumeTipDescriereValori acceptate
tipopțional string Filtrează pe tipul localității. ex. satex. localitate_componenta

Cum se comportă

  • Sare peste nivelul UAT. Fiecare rând poartă UAT-ul, ca să distingi satele omonime.

La ce folosește

  • Umpli un singur dropdown „localitate" pe județ, sărind nivelul UAT.
  • Acoperire teritorială a unui curier/agent pe județ: enumeri toate localitățile de deservit.
  • Export/raportare pe județ: lista completă de localități, fiecare cu UAT-ul-mamă atașat.

Structura răspunsului

CâmpTipDescriere
data[].cod_siruta integer Codul SIRUTA (cheia publică a entității).
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[].lat number | null Latitudine (WGS84).
data[].lng number | null Longitudine (WGS84).
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.
data[].uat object UAT-ul din care face parte localitatea.
data[].uat.cod_siruta integer Codul SIRUTA al UAT-ului — chainable spre /uat/{cod}.
data[].uat.nume string Denumirea UAT-ului.
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/localitati
{
    "data": [
        {
            "cod_siruta": 54984,
            "nume": "Cluj-Napoca",
            "tip": "resedinta_municipiu",
            "populatie": 286598,
            "lat": 46.78,
            "lng": 23.559444444444,
            "nr_firme": 114118,
            "nr_firme_functiune": 50565,
            "uat": {
                "cod_siruta": 54975,
                "nume": "Cluj-Napoca"
            }
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 434,
            "pagini": 22
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitJudețul nu există.
422validareUn parametru nu a trecut validarea (tip); detalii spune care şi de ce.
429cota_depasitaCota 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."
            ]
        }
    }
}