Locations v1 / Străzi

Streets of a locality

The paginated list of a locality's streets (cod_siruta), with prefix search (q) and deduplication of ghost variants (the same name twice). are_geo marks the streets that have geometry.

GET

https://oneapi.ro/api/locations/v1/localitati/{cod}/strazi

Path parameters

NameTypeDescriptionExample

codrequired string SIRUTA code of the locality (e.g. 54984).

Query parameters

NameTypeDescriptionAccepted values

qoptional string | null Search prefix within the locality's streets. e.g. memorandumuluie.g. acvariului

How it behaves

Nationwide street search is not allowed — always give the locality context.
Ghost variants (same name, duplicated in the Ministry of Finance data) are deduplicated on display; the one with geometry wins.
are_geo = it has an OSM line, so the geometric detail (length, intersections, endpoints) is available.

What it is for

Street autocomplete in the address form, once the customer has picked the locality.
Populating a street dropdown at checkout, filtered to the locality in the basket.
Checking that a manually typed street really does belong to the declared locality.

Response structure

FieldTypeDescription

data[].id integer The street's (internal) identifier — the key for /strazi/{id}.

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

data[].tip string Thoroughfare type code (names at /nomenclatoare/tipuri).

data[].cod_postal string | null The street's postal code, where a single one covers the whole thoroughfare.

data[].are_geo boolean The street has geometry (an OSM line) attached — the segment and intersection routes depend on it.

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/localitati/54984/strazi

{
    "data": [
        {
            "id": 14612,
            "nume": "11 Octombrie",
            "tip": "strada",
            "cod_postal": "400211",
            "are_geo": true
        }
    ],
    "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"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1217,
            "pagini": 61
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/localitati/54984/strazi?q=memorandumului

{
    "data": [
        {
            "id": 14540,
            "nume": "Memorandumului",
            "tip": "strada",
            "cod_postal": "400114",
            "are_geo": true
        }
    ],
    "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"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "pagini": 1
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/localitati/179196/strazi?q=acvariului

{
    "data": [
        {
            "id": 221472,
            "nume": "Acvariului",
            "tip": "strada",
            "cod_postal": "061493",
            "are_geo": true
        }
    ],
    "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"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 1,
            "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 locality does not exist.
422	validare	A parameter failed validation (`q`); `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 (q); detalii says which and why.",
        "detalii": {
            "cod": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}