Locations v1 / Referință & business

Meta / state of the data

Data freshness by domain plus coverage (counts: counties, administrative units, localities, streets with geometry, addresses).

GET

https://oneapi.ro/api/locations/v1/meta

Query parameters

This route accepts no query parameters.

How it behaves

Data freshness by domain plus coverage (counts). Good for a data status or health check.

What it is for

A data health check in a monitor: confirming the imports are recent.
Showing a „data updated on…" line in the UI, for confidence.
Cache busting: refreshing a local cache when coverage or freshness changes.

Response structure

All fields below live inside data.

FieldTypeDescription

actualizat.administrativ string | null When the SIRUTA nomenclature was last fetched.

actualizat.geo string | null When the administrative boundaries were last fetched.

actualizat.populatie string | null When the census was last fetched.

actualizat.strazi string | null When the streets were last fetched.

actualizat.adrese string | null When the address points were last fetched.

acoperire.judete integer How many counties the nomenclature holds.

acoperire.uat integer How many administrative units the nomenclature holds.

acoperire.localitati integer How many active localities the nomenclature holds.

acoperire.strazi_cu_geometrie integer How many streets have an OSM line (partial coverage, not all of them).

acoperire.adrese integer The number of addresses (house numbers) known in the data.

Response examples

GEThttps://oneapi.ro/api/locations/v1/meta

{
    "data": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00",
            "populatie": "2026-08-15T16: 40: 07+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "adrese": "2026-10-06T16: 33: 40+03: 00"
        },
        "acoperire": {
            "judete": 42,
            "uat": 3181,
            "localitati": 13755,
            "strazi_cu_geometrie": 94290,
            "adrese": 1044346
        }
    }
}

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.
422	validare	The route takes no parameters apart from `lang`: any other parameter returns 422 instead of being ignored.
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": "validare",
        "mesaj": "The route takes no parameters apart from lang: any other parameter returns 422 instead of being ignored."
    }
}