Locations v1 / Șomaj & construcții

Seria de autorizații a unui județ

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

GET

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

Parametri de cale

NumeTipDescriereExemplu

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

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 categorii, la nivel de județ. Implicit rezidentiale.
⚠️ Categoriile alte/comert/hoteluri încep în 2009; înainte erau în alte_agregat.

La ce folosește

Grafic al activității de construcții dintr-un județ, din 2002.
Linie de referință peste care se suprapune seria unui UAT.
Măsurarea impactului crizei din 2009 pe o zonă.

Structura răspunsului

CâmpTipDescriere

data.entitate string Numele județ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/judete/CJ/autorizatii/serie

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

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/autorizatii/serie?categorie=comert

{
    "data": {
        "entitate": "Cluj",
        "categorie": "comert",
        "sursa": "INS (autorizaţii de construire)",
        "serie": [
            {
                "an": 2009,
                "numar": 22,
                "mp_utili": 53127
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

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

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

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

{
    "data": {
        "entitate": "București",
        "categorie": "rezidentiale",
        "sursa": "INS (autorizaţii de construire)",
        "serie": [
            {
                "an": 2002,
                "numar": 1020,
                "mp_utili": 311566
            }
        ]
    },
    "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 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."
            ]
        }
    }
}