Locations v1 / Șomaj & construcții

Autorizațiile de construire ale unui județ

Autorizațiile eliberate în județ la ultimul an publicat, pe categorii.

GET

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

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul judeţului, două litere (ex. CJ). Bucureştiul e B.

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Totalul județean publicat de sursă, pe categorii.
Contrastele sunt mari și instructive: în 2025, județul Ilfov a avut 3.610 autorizații rezidențiale, față de 403 în municipiul București — inelul construiește, capitala nu.

La ce folosește

Cât se construiește într-un județ, pe categorii, la ultimul an.
Comparație între județe pentru planificare comercială.
Context pentru cifrele unui UAT din județ.

Structura răspunsului

CâmpTipDescriere

data.entitate string Numele județului.

data.an integer Ultimul an publicat.

data.sursa string Sursa datelor.

data.categorii[].categorie string Categoria de construcție.

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/judete/CJ/autorizatii

{
    "data": {
        "entitate": "Cluj",
        "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/judete/IF/autorizatii

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

GEThttps://oneapi.ro/api/locations/v1/judete/AB/autorizatii

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

GEThttps://oneapi.ro/api/locations/v1/judete/B/autorizatii

{
    "data": {
        "entitate": "București",
        "an": 2025,
        "sursa": "INS (autorizaţii de construire)",
        "categorii": [
            {
                "categorie": "administrative",
                "numar": 3,
                "mp_utili": 8558
            }
        ]
    },
    "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	Județ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": "Județul nu există sau n-are autorizații publicate."
    }
}