Locations v1 / Șomaj & construcții

Unemployment in a county

The number and the share of registered unemployed in the county (registration prefix, e.g. CJ), at the latest published month. The county total, not the sum of the units listed separately.

GET

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

Path parameters

NameTypeDescriptionExample

codrequired string County code, two letters (e.g. CJ). Bucharest is B.

Query parameters

This route accepts no query parameters.

How it behaves

The county total as published by the source. Verified: it matches the sum of the county's units exactly.
⚠️ pondere is measured against labour resources, not the civilian active population — see numitor.

What it is for

A county report header: how many unemployed, at which month.
Comparing counties at the same period.
Context for a unit's figures — how much of the county they represent.

Response structure

FieldTypeDescription

data.entitate string The name of the county.

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.

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

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 county does not exist or has no 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 county does not exist or has no data."
    }
}