Locations v1 / Străzi

Postcodes of a street

The street's postal codes at house-number and block level (Ministry of Finance data), grouped by code with number ranges and blocks.

GET

https://oneapi.ro/api/locations/v1/strazi/{id}/coduri-postale

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 street's postal codes from the Ministry of Finance data, grouped by code with number ranges and blocks.

What it is for

Assigning the postal code automatically from the house number at checkout.
Validating the postal code the customer typed against the given street and number.
Filling in the postal code on a courier waybill.

Response structure

FieldTypeDescription

data[].cod_postal string The postal code.

data[].numere[] array The number ranges covered by the code, with parity.

data[].numere[].start integer | null The first number in the range.

data[].numere[].sfarsit integer | null The last number in the range.

data[].numere[].paritate string | null The parity of the range (even / odd numbers); null when it is continuous.

data[].blocuri[] string The blocks the code applies to.

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

Response examples

GEThttps://oneapi.ro/api/locations/v1/strazi/103906/coduri-postale

{
    "data": [
        {
            "cod_postal": "130003",
            "numere": [
                {
                    "start": 135,
                    "sfarsit": 177,
                    "paritate": "impar"
                }
            ],
            "blocuri": []
        }
    ],
    "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"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/216508/coduri-postale

{
    "data": [
        {
            "cod_postal": "012351",
            "numere": [
                {
                    "start": 1,
                    "sfarsit": 19,
                    "paritate": "impar"
                }
            ],
            "blocuri": []
        }
    ],
    "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"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/strazi/221714/coduri-postale

{
    "data": [
        {
            "cod_postal": "061931",
            "numere": [
                {
                    "start": 1,
                    "sfarsit": 3,
                    "paritate": "impar"
                }
            ],
            "blocuri": []
        }
    ],
    "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"
        }
    }
}

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