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_code | string | Yes | ISO 3166-1 alpha-2 country code (e.g., "RO", "BG") - Path parameter |
| locality_id | number | Yes | Unique identifier of the locality - Path parameter |
| search | string | Yes | Search 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 |
|---|---|---|
| 200 | Success | Streets found successfully |
| 400 | Bad Request | Invalid request parameters (e.g., search term must be at least 2 characters long) |
| 401 | Unauthorized | Invalid or missing API key |
| 404 | Not Found | No streets found |
| 422 | Validation Error | Validation error (country_code, locality_id, search field required, invalid format, etc.) |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | An unexpected error occurred |
Response Format
| Field | Type | Description |
|---|---|---|
| [].id | integer | Unique street identifier |
| [].street_name | string | Full street name (short_street_name from localities_streets table) |
| [].postal_code | string | Postal 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
