oneapi
Autentificare
Locations v1 / Educatie

Unitățile de învățământ ale unui UAT

Unităţile de învăţământ din UAT, cu personalitate juridică şi structurile arondate lor, pe nivel şi pe mediu. Din reţeaua şcolară oficială, nu din estimări.

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

Parametri de cale

NumeTipDescriereExemplu
codobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale (ex. 54975 pentru Cluj-Napoca).

Parametri de interogare

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

Cum se comportă

  • Sursa e Rețeaua școlară a Ministerului Educației. Legătura cu teritoriul se face pe codul SIRUTA al localității, pe care fiecare unitate îl poartă — verificat: toate cele 18.022 de unități se rezolvă în nomenclator.
  • sumar desparte deliberat unitățile cu personalitate juridică (unitati_pj) de structurile arondate (structuri_arondate) — localurile subordonate. Sunt lucruri diferite: o comună cu o școală și patru grădinițe subordonate are unitati_pj: 1, nu „5 școli". Un total unic ar umfla cifra de câteva ori.
  • unitati e paginată, fiindcă un municipiu mare are sute de unități (Cluj-Napoca: 200). Sumarul, defalcarea pe tip și pe mediu se calculează pe TOT UAT-ul, indiferent de paginare.
  • cod_siiir e identificatorul oficial al unității în sistemul Ministerului Educației — cheia stabilă, dacă vrei să urmărești aceeași unitate în timp.

La ce folosește

  • Afișezi rețeaua școlară pe pagina de detaliu a unei comune sau a unui oraș.
  • Compari acoperirea educațională între UAT-uri (câte unități, de ce fel, urban/rural).
  • Verifici dacă o localitate are grădiniță sau școală gimnazială înainte de o decizie de relocare/investiție.

Structura răspunsului

CâmpTipDescriere
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.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 Totalul înregistrărilor din rețea pentru teritoriul cerut.
data.pe_tip[] array Defalcare pe tipul unității [{tip, nr}] (unitate de învățământ, club sportiv școlar etc.).
data.pe_tip[].tip string
data.pe_tip[].nr integer Numărul de elemente din grupa asta.
data.pe_mediu object Defalcare urban/rural, după mediul declarat al unității.
data.pe_mediu.urban integer
data.unitati[] array Lista paginată: {denumire, cod_siiir, cui?, statut, tip, mediu, adresa?, an_scolar, 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/uat/54975/educatie
{
    "data": {
        "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.
404negasitUAT 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."
            ]
        }
    }
}