Direct API

Streets Search

Search for streets within a specific locality

GET
/search/streets/{country_code}/{locality_id}/{search}

Search for streets in a specific locality. Matches street names that start with the search term or have a word starting with it.

Parameters

Name Type Required Description
country_codestringYesISO 3166-1 alpha-2 country code (e.g., "RO", "BG") - Path parameter
locality_idnumberYesUnique identifier of the locality - Path parameter
searchstringYesSearch term for street name. Matches start of street name or start of words in street name. Minimum 2 characters, maximum 100 characters. - Path parameter

Response Codes

Code Status Description
200SuccessStreets found successfully
400Bad RequestInvalid request parameters (e.g., search term must be at least 2 characters long)
401UnauthorizedInvalid or missing API key
404Not FoundNo streets found
422Validation ErrorValidation error (country_code, locality_id, search field required, invalid format, etc.)
429Too Many RequestsRate limit exceeded
500Internal Server ErrorAn unexpected error occurred

Response Format

Field Type Description
[].idintegerUnique street identifier
[].street_namestringFull street name (short_street_name from localities_streets table)
[].postal_codestringPostal code for the street

Response Example

RESPONSEJSON
[
  {
    "id": 46992,
    "street_name": "Calea Victoriei",
    "postal_code": "010099"
  },
  {
    "id": 47120,
    "street_name": "Pasajul Victoriei",
    "postal_code": "010023"
  }
]

Complete API Reference

For interactive testing and additional technical details, visit our complete Swagger documentation.

View in Swagger Documentation