oneapi
Autentificare
Locations v1 / Educatie

Unitățile de învățământ ale unei localități

Unităţile de învăţământ din chiar localitatea cerută — util acolo unde un UAT are şcoli în mai multe sate, iar întrebarea e despre unul singur.

GET
https://oneapi.ro/api/locations/v1/localitati/{cod}/educatie

Parametri de cale

NumeTipDescriereExemplu
codobligatoriu string Codul SIRUTA al localităţii (ex. 54984).

Parametri de interogare

NumeTipDescriereValori acceptate
per_paginaopțional text Câte unități întoarce lista (implicit 50, maxim 200). ex. 50
paginaopțional text Pagina, numărată de la 1. ex. 1

Cum se comportă

  • Spre deosebire de ruta pe UAT, aici numărătorile sunt strict pentru localitatea cerută — util fiindcă într-o comună cu mai multe sate unitățile nu sunt distribuite uniform.
  • Aceleași reguli: sumar separă unitățile cu personalitate juridică de structurile arondate, iar unitati e paginată.

La ce folosește

  • Afli ce unități de învățământ există chiar în satul/localitatea cerută, nu în toată comuna.
  • Verifici dacă un sat are grădiniță proprie sau copiii merg în localitatea vecină.

Structura răspunsului

CâmpTipDescriere
data.localitate object Localitatea interogată (cod SIRUTA, nume).
data.localitate.cod_siruta integer Codul SIRUTA al unităţii teritoriale.
data.localitate.nume string Numele, aşa cum îl publică sursa.
data.uat.cod_siruta integer Codul SIRUTA al unităţii teritoriale.
data.uat.nume string Numele, aşa cum îl publică sursa.
data.uat.tip string Tipul UAT-ului (municipiu/oraș/comună).
data.judet.cod_siruta integer Codul SIRUTA al unităţii teritoriale.
data.judet.nume string Numele, aşa cum îl publică sursa.
data.judet.cod_auto string Indicativul auto al judeţului.
data.sumar object Numărătorile pentru localitate: {unitati_pj, structuri_arondate, total}.
data.sumar.unitati_pj integer Unități cu personalitate juridică (școala ca entitate).
data.sumar.structuri_arondate integer Structuri subordonate (localuri, grădinițe arondate).
data.sumar.total integer
data.pe_tip[].tip string
data.pe_tip[].nr integer Numărul de elemente din grupa asta.
data.pe_mediu.urban integer
data.unitati[] array Lista paginată a unităților din localitate.
data.unitati[].denumire string Denumirea, aşa cum o publică sursa.
data.unitati[].cod_siiir string
data.unitati[].cui integer Codul de identificare fiscală, fără prefixul RO.
data.unitati[].statut string Starea în care se află elementul la sursă.
data.unitati[].tip string
data.unitati[].mediu string Mediul de rezidenţă (urban ori rural).
data.unitati[].adresa string Adresa, în forma publicată de sursă.
data.unitati[].an_scolar string
data.unitati[].localitate.nume string Numele, aşa cum îl publică sursa.
data.unitati[].localitate.cod_siruta integer Codul SIRUTA al unităţii teritoriale.
meta.paginare.pagina integer Pagina curentă, numărată de la 1.
meta.paginare.per_pagina integer Câte înregistrări are o pagină.
meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.
meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/localitati/54984/educatie
{
    "data": {
        "localitate": {
            "cod_siruta": 54984,
            "nume": "Cluj-Napoca"
        },
        "uat": {
            "cod_siruta": 54975,
            "nume": "Cluj-Napoca",
            "tip": "municipiu"
        },
        "judet": {
            "cod_siruta": 127,
            "nume": "Cluj",
            "cod_auto": "CJ"
        },
        "sumar": {
            "unitati_pj": 147,
            "structuri_arondate": 53,
            "total": 200
        },
        "pe_tip": [
            {
                "tip": "Unitate de învățământ",
                "nr": 192
            }
        ],
        "pe_mediu": {
            "urban": 200
        },
        "unitati": [
            {
                "denumire": "COLEGIUL TERȚIAR NONUNIVERSITAR AL USAMV CLUJ-NAPOCA",
                "cod_siiir": "1262105561",
                "cui": 4288381,
                "statut": "AR",
                "tip": "Unitate de învățământ",
                "mediu": "urban",
                "adresa": "Calea Mănăștur nr. 3-5",
                "an_scolar": "2025-2026",
                "localitate": {
                    "nume": "Cluj-Napoca",
                    "cod_siruta": 54984
                }
            }
        ]
    },
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 50,
            "total": 200,
            "pagini": 4
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitLocalitate inexistentă pentru codul SIRUTA dat.
422validareUn parametru nu a trecut validarea (per_pagina, pagina); 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 (per_pagina, pagina); detalii spune care şi de ce.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}