Locations v1 / Șomaj & construcții

Unemployment in an administrative unit

⭐ The number and the share of registered unemployed in the administrative unit (SIRUTA code), at the latest published month, in total and by sex.

GET

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

Path parameters

NameTypeDescriptionExample

codrequired string SIRUTA code of the administrative-territorial unit (e.g. 54975 for Cluj-Napoca).

Query parameters

This route accepts no query parameters.

How it behaves

⭐ Registered unemployment goes all the way down to commune level — 3,181 units, monthly since January 2010. This route gives the latest published month; the trend is at /uat/{cod}/somaj/serie.
⚠️ pondere is not the unemployment rate. The denominator here is labour resources, not the civilian active population — the numitor field says so explicitly. For the same month, the two measures give different figures, and that is not a contradiction.
The link to the nomenclature is exact: all 3,181 SIRUTA codes in the source match locations_uat. The response gives the canonical name, with diacritics.
The same figures can also be queried along the source's own dimensions (window, county, totals); this route addresses them the other way round, from the entity.

What it is for

The record of a commune or town: how many registered unemployed it has now.
A risk signal in area scoring, alongside the number of companies.
Comparing neighbouring units at the same month.

Response structure

FieldTypeDescription

data.entitate string The unit's canonical name.

data.perioada.an integer The year of the latest published month.

data.perioada.luna integer The month (1–12).

data.numitor string What pondere is measured against — labour resources.

data.sursa string The data source.

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

data.somaj[].numar number | null The number of registered unemployed.

data.somaj[].pondere number | null The share of labour resources, as a percentage.

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

Response examples

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"
        }
    }
}

Error codes

Code	Slug	When it occurs
401	neautentificat	Token missing, invalid, expired or revoked.
403	feature_indisponibil	The current plan does not include the feature the route depends on.
404	negasit	The administrative unit does not exist or has no unemployment data.
429	cota_depasita	The plan's monthly quota has been exceeded (see `Retry-After`).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "negasit",
        "mesaj": "The administrative unit does not exist or has no unemployment data."
    }
}