Locations v1 / Proximitate & zone

Neighbours of an administrative unit

The administrative units adjacent to a unit (those sharing a border), ordered by the length of the shared border. Identified by cod_siruta.

GET

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

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

Ordered by the length of the shared border (descending).

What it is for

Extending a delivery zone to the neighbouring communes and towns.
Assigning couriers to adjacent units for compact routes.
Identifying the border localities relevant to municipal services.

Response structure

FieldTypeDescription

data[].cod_siruta integer The SIRUTA code of the neighbouring unit (its public key).

data[].nume string The name of the neighbouring unit.

data[].tip string The type of the neighbouring unit (municipality/town/commune).

data[].judet.cod string The registration prefix of the neighbour's county — it can differ from that of the requested unit.

data[].judet.nume string The name of the neighbour's county.

data[].lungime_granita_m integer The length of the shared border, in metres.

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

Response examples

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

{
    "data": [
        {
            "cod_siruta": 55687,
            "nume": "Apahida",
            "tip": "comuna",
            "judet": {
                "cod": "CJ",
                "nume": "Cluj"
            },
            "lungime_granita_m": 23833
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

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

{
    "data": [
        {
            "cod_siruta": 155314,
            "nume": "Giroc",
            "tip": "comuna",
            "judet": {
                "cod": "TM",
                "nume": "Timiș"
            },
            "lungime_granita_m": 15129
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

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

{
    "data": [
        {
            "cod_siruta": 1017,
            "nume": "Alba Iulia",
            "tip": "municipiu",
            "judet": {
                "cod": "AB",
                "nume": "Alba"
            },
            "lungime_granita_m": 17064
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

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