Locations v1 / Proximitate & zone

Neighbours of a county

The counties adjacent to a county, ordered by the length of the shared border. Identified by the registration prefix.

GET

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

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 is identified by its registration prefix (cod, e.g. CJ), not by a SIRUTA code.
Adjacency = a shared border on the official ANCPI boundaries; the list is ordered by lungime_granita_m descending.

What it is for

Extending a service's coverage to the neighbouring counties.
Routing field agents or representatives across groups of adjacent counties.
Aggregating campaigns or stock across neighbouring counties.

Response structure

FieldTypeDescription

data[].cod string The registration prefix of the neighbouring county (e.g. AB, SJ, MS).

data[].nume string The name of the entity.

data[].lungime_granita_m integer The length of the border shared with the queried county, in metres (the sort key).

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

Response examples

GEThttps://oneapi.ro/api/locations/v1/judete/CJ/vecini

{
    "data": [
        {
            "cod": "SJ",
            "nume": "Sălaj",
            "lungime_granita_m": 238204
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

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

{
    "data": [
        {
            "cod": "SB",
            "nume": "Sibiu",
            "lungime_granita_m": 199438
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

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

{
    "data": [
        {
            "cod": "IF",
            "nume": "Ilfov",
            "lungime_granita_m": 103538
        }
    ],
    "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 county 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 county does not exist."
    }
}