Locations v1 / Șomaj & construcții

Șomajul unui UAT

⭐ Numărul și ponderea șomerilor înregistrați în UAT (cod SIRUTA), la ultima lună publicată,
pe total și pe sexe.

GET

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

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ă

⭐ Șomajul înregistrat coboară până la nivel de comună — 3.181 de UAT-uri, lunar din ianuarie 2010. Aici se dă ultima lună publicată; evoluția e la /uat/{cod}/somaj/serie.
⚠️ pondere nu e rata șomajului. Numitorul aici sunt resursele de muncă, nu populația activă civilă — câmpul numitor o spune explicit. Pe aceeași lună, cele două măsuri dau cifre diferite, și nu e o contradicție.
Legătura cu nomenclatorul e exactă: toate cele 3.181 de coduri SIRUTA din sursă se potrivesc cu locations_uat. Răspunsul dă denumirea canonică, cu diacritice.
Aceleași cifre sunt interogabile și pe dimensiunile sursei (fereastră, județ, totaluri); ruta asta le adresează invers, dinspre entitate.

La ce folosește

Fișa unei comune sau a unui oraș: câți șomeri înregistrați are acum.
Semnal de risc într-un scoring de zonă, alături de numărul de firme.
Comparație între UAT-uri vecine, la aceeași lună.

Structura răspunsului

CâmpTipDescriere

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

data.perioada.an integer Anul ultimei luni publicate.

data.perioada.luna integer Luna (1–12).

data.numitor string La ce se raportează pondere — resursele de muncă.

data.sursa string Sursa datelor.

data.somaj[].sex string total, masculin sau feminin.

data.somaj[].numar number | null Numărul de șomeri înregistrați.

data.somaj[].pondere number | null Ponderea în resursele de muncă, în procente.

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

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/uat/54975/somaj

{
    "data": {
        "entitate": "Cluj-Napoca",
        "perioada": {
            "an": 2026,
            "luna": 7
        },
        "numitor": "resurse de muncă",
        "sursa": "INS (şomaj înregistrat)",
        "somaj": [
            {
                "sex": "total",
                "numar": 756,
                "pondere": 0.4
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

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

{
    "data": {
        "entitate": "Timișoara",
        "perioada": {
            "an": 2026,
            "luna": 7
        },
        "numitor": "resurse de muncă",
        "sursa": "INS (şomaj înregistrat)",
        "somaj": [
            {
                "sex": "total",
                "numar": 858,
                "pondere": 0.5
            }
        ]
    },
    "meta": {
        "actualizat": {
            "somaj": "2026-09-14",
            "autorizatii": "2026-04-01"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/1071/somaj

{
    "data": {
        "entitate": "Ciugud",
        "perioada": {
            "an": 2026,
            "luna": 7
        },
        "numitor": "resurse de muncă",
        "sursa": "INS (şomaj înregistrat)",
        "somaj": [
            {
                "sex": "total",
                "numar": 17,
                "pondere": 0.8
            }
        ]
    },
    "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 nu are date de șomaj.
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 nu are date de șomaj."
    }
}