Locations v1 / Străzi

House numbers of a street

The street's address points (house number + coordinates + postal code), from OSM, paginated.

GET

https://oneapi.ro/api/locations/v1/strazi/{id}/adrese

Path parameters

NameTypeDescriptionExample

idrequired string Internal identifier of the street — obtained from a street search.

Query parameters

This route accepts no query parameters.

How it behaves

The address points from OSM (number + coordinates), paginated.

What it is for

Placing house numbers as markers on a map for one street.
Finding the postal code of a specific number on a street.
Confirming that a number exists on the street when validating a delivery address.

Response structure

FieldTypeDescription

data[].numar string The house number, as text (it may carry a suffix, e.g. 12A).

data[].cod_postal string | null The postal code of the point; null when OSM does not have it.

data[].lat number The latitude of the address point (OSM).

data[].lng number The longitude of the address point (OSM).

meta.paginare.pagina integer Pagina curentă.

meta.paginare.per_pagina integer Rezultate pe pagină.

meta.paginare.total integer Total rezultate.

meta.paginare.pagini integer Număr de pagini.

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

Response examples

GEThttps://oneapi.ro/api/locations/v1/strazi/16416/adrese?per_pagina=20

{
    "data": [
        {
            "numar": "2",
            "cod_postal": "400487",
            "lat": 46.75725404999999,
            "lng": 23.5865691
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 4,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/216508/adrese

{
    "data": [
        {
            "numar": "2",
            "cod_postal": null,
            "lat": 44.4758653,
            "lng": 26.0466588
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 176,
            "pagini": 9
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/16416/adrese?per_pagina=5

{
    "data": [
        {
            "numar": "2",
            "cod_postal": "400487",
            "lat": 46.75725404999999,
            "lng": 23.5865691
        }
    ],
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00",
            "strazi": "2026-10-04T19: 50: 09+03: 00",
            "geo": "2026-10-06T16: 33: 40+03: 00"
        },
        "atribuire": "© OpenStreetMap contributors",
        "paginare": {
            "pagina": 1,
            "per_pagina": 5,
            "total": 4,
            "pagini": 1
        }
    }
}

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 street 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 street does not exist."
    }
}