Locations v1 / Șomaj & construcții

Autorizațiile de construire ale unui UAT

⭐ Autorizațiile eliberate în UAT la ultimul an publicat, pe categorii, cu numărul și
suprafața utilă (m²).

GET

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

Parametri de cale

NumeTipDescriereExemplu

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

⭐ Autorizațiile de construire pe UAT, anual din 2002, cu numărul și suprafața utilă. Aici e ultimul an publicat; evoluția e la /uat/{cod}/autorizatii/serie.
Cifrele arată lucruri pe care media județeană le ascunde: în 2025, comunele Moșnița Nouă (511), Miroslava (440) și Berceni (414) au avut fiecare mai multe autorizații rezidențiale decât tot municipiul București (403).
Categoriile lipsă nu se întorc cu zero — sursa pur și simplu nu publică rândul, ceea ce nu e același lucru cu „zero autorizații".
9 comune din 3.181 n-au nicio autorizație publicată în tot intervalul 2002–2025; pentru ele ruta dă 404, nu o listă goală.

La ce folosește

Cât se construiește într-o comună sau într-un oraș, chiar acum.
Indicator de creștere a unei zone, alături de numărul de firme noi.
Prospectare pentru materiale de construcții sau servicii conexe.

Structura răspunsului

CâmpTipDescriere

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

data.an integer Ultimul an publicat pentru această entitate.

data.sursa string Sursa datelor.

data.categorii[].categorie string Categoria de construcție (vezi nomenclatorul).

data.categorii[].numar number | null Câte autorizații s-au eliberat.

data.categorii[].mp_utili number | null Suprafața utilă autorizată, î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

{
    "data": {
        "entitate": "Cluj-Napoca",
        "an": 2025,
        "sursa": "INS (autorizaţii de construire)",
        "categorii": [
            {
                "categorie": "administrative",
                "numar": 2,
                "mp_utili": 12195
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/155243/autorizatii

{
    "data": {
        "entitate": "Timișoara",
        "an": 2025,
        "sursa": "INS (autorizaţii de construire)",
        "categorii": [
            {
                "categorie": "administrative",
                "numar": 1,
                "mp_utili": 378
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/95060/autorizatii

{
    "data": {
        "entitate": "Iași",
        "an": 2025,
        "sursa": "INS (autorizaţii de construire)",
        "categorii": [
            {
                "categorie": "administrative",
                "numar": 2,
                "mp_utili": 570
            }
        ]
    },
    "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 nu există sau n-are autorizații publicate.
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": "negasit",
        "mesaj": "UAT-ul nu există sau n-are autorizații publicate."
    }
}