Locations v1 / Proximitate & zone

Do you deliver here?

⭐ Checks whether a location (a lat/lng point or a cod_postal) falls inside a delivery zone defined by an administrative unit (uat=cod_siruta) ± its neighbours. When it falls outside, it returns the nearest unit in the zone plus the distance.

GET

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

Query parameters

NameTypeDescriptionAccepted values

latoptional number | null The latitude of the location (or use cod_postal). -90 – 90

lngoptional number | null The longitude of the location. -180 – 180

cod_postaloptional string | null A postal code (an alternative to lat/lng). e.g. 400001

uatrequired integer The cod_siruta of the zone's administrative unit. e.g. 54975e.g. 179132e.g. 114319

include_vecinioptional boolean | null Extends the zone to the neighbours.

How it behaves

Does the location (a lat/lng point or a cod_postal) fall inside a unit's zone (± neighbours)?
When it falls outside, it returns cel_mai_apropiat — the nearest unit in the zone — plus the distance.

What it is for

A „do you deliver to me?" button on the product page or at checkout, checked by postal code or pin.
Filtering out orders that fall outside a shop's zone before accepting them.
Suggesting the nearest pickup point or unit when the customer's address falls outside the zone.

Response structure

FieldTypeDescription

data.acoperit boolean true if the location falls inside the unit's zone (± neighbours when include_vecini=1).

data.uat object The unit in the zone the point falls in; null when the location is outside the zone.

data.uat.cod_siruta integer The SIRUTA code of the administrative unit — chainable to /uat/{cod}.

data.uat.nume string The name of the administrative unit.

data.uat.tip string The type of unit (municipality/town/commune).

data.cel_mai_apropiat object Present only when acoperit=false: the nearest unit in the zone.

data.cel_mai_apropiat.cod_siruta integer The SIRUTA code of the nearest covered unit, when the point falls outside.

data.cel_mai_apropiat.nume string The name of the nearest covered unit.

data.cel_mai_apropiat.distanta_m integer Distance (metres) to the edge of the nearest unit in the zone.

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

Response examples

GEThttps://oneapi.ro/api/locations/v1/acoperim?lat=46.77&lng=23.59&uat=54975

{
    "data": {
        "acoperit": true,
        "uat": {
            "cod_siruta": 54975,
            "nume": "Cluj-Napoca",
            "tip": "municipiu"
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/acoperim?lat=44.43&lng=26.10&uat=179132

{
    "data": {
        "acoperit": true,
        "uat": {
            "cod_siruta": 179132,
            "nume": "București",
            "tip": "municipiu"
        }
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "geo": "2026-09-04T21: 24: 20+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/acoperim?lat=46.54&lng=24.56&uat=114319

{
    "data": {
        "acoperit": true,
        "uat": {
            "cod_siruta": 114319,
            "nume": "Târgu Mureș",
            "tip": "municipiu"
        }
    },
    "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 zone's administrative unit or the postal code does not exist.
422	validare	A parameter failed validation (`lat`, `lng`, `cod_postal` etc.); `detalii` says which and why.
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": "A parameter failed validation (lat, lng, cod_postal etc.); detalii says which and why.",
        "detalii": {
            "lat": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}