Locations v1 / Șomaj & construcții

Seria de autorizații a unui UAT

Evoluția anuală a unei categorii de autorizații, din 2002.

GET

https://oneapi.ro/api/locations/v1/uat/{cod}/autorizatii/serie

Parametri de cale

NumeTipDescriereExemplu

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

Parametri de interogare

NumeTipDescriereValori acceptate

categorieopțional string | null Ce categorie. rezidentialeadministrativecomerthotelurialtealte_agregatrezidentiale_colectivitati

de_laopțional integer | null Anul de început. 2002 – 2100

pana_laopțional integer | null Anul de sfârșit. 2002 – 2100

Cum se comportă

Seria anuală a unei singure categorii, din 2002. Fiecare punct are și numărul, și suprafața utilă.
Implicit rezidentiale — singura categorie publicată neîntrerupt din 2002.
⚠️ O serie de comert, hoteluri sau alte începe abia în 2009: înainte, toate stăteau în alte_agregat. Intervalele exacte sunt la /statistici/autorizatii/categorii.

La ce folosește

Grafic „cât s-a construit aici în ultimii 20 de ani".
Identificarea boom-urilor imobiliare locale și a opririlor.
Corelarea cu populația: unde se construiește fără ca populația să crească.

Structura răspunsului

CâmpTipDescriere

data.entitate string Denumirea canonică a UAT-ului.

data.categorie string Categoria cerută.

data.sursa string Sursa datelor.

data.serie[].an integer Anul punctului.

data.serie[].numar number | null Câte autorizații în acel an.

data.serie[].mp_utili number | null Suprafața utilă autorizată în acel an, în m².

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/uat/54975/autorizatii/serie

{
    "data": {
        "entitate": "Cluj-Napoca",
        "categorie": "rezidentiale",
        "sursa": "INS (autorizaţii de construire)",
        "serie": [
            {
                "an": 2002,
                "numar": 340,
                "mp_utili": 54335
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/54975/autorizatii/serie?de_la=2020-01&pana_la=2023-12

{
    "data": {
        "entitate": "Cluj-Napoca",
        "categorie": "rezidentiale",
        "sursa": "INS (autorizaţii de construire)",
        "serie": [
            {
                "an": 2020,
                "numar": 496,
                "mp_utili": 185310
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/155243/autorizatii/serie?de_la=2015-01&pana_la=2019-12

{
    "data": {
        "entitate": "Timișoara",
        "categorie": "rezidentiale",
        "sursa": "INS (autorizaţii de construire)",
        "serie": [
            {
                "an": 2015,
                "numar": 262,
                "mp_utili": 100063
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

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	UAT-ul sau categoria nu există.
422	validare	Fereastră inversată sau an în afara intervalului.
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": "validare",
        "mesaj": "Fereastră inversată sau an în afara intervalului.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}