Locations v1 / Șomaj & construcții

Șomajul unui județ

Numărul și ponderea șomerilor înregistrați în județ (cod auto, ex. CJ), la ultima lună
publicată. Totalul județului, nu suma UAT-urilor listate separat.

GET

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

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țului publicat de sursă. Verificat: coincide exact cu suma UAT-urilor din județ.
⚠️ pondere se raportează la resursele de muncă, nu la populația activă civilă — vezi numitor.

La ce folosește

Header de raport județean: câți șomeri, la ce lună.
Comparație între județe la aceeași perioadă.
Context pentru cifrele unui UAT — cât din județ înseamnă.

Structura răspunsului

CâmpTipDescriere

data.entitate string Numele județului.

data.perioada.an integer Anul ultimei luni publicate.

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

data.numitor string La ce se raportează pondere.

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

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

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

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

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

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