Direct API
Postal Code Reverse Lookup
Find location details for a specific postal code
GET
/search/postal-code-reverse/{country_code}/{postal_code}
Find location details for a specific postal code within a country
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| country_code | string | Yes | ISO 3166-1 alpha-2 country code (e.g., "RO", "BG") - Path parameter |
| postal_code | string | Yes | Postal code to lookup (e.g., "010099", "400001") - Path parameter |
Response Codes
| Code | Status | Description |
|---|---|---|
| 200 | Success | Successful operation |
| 401 | Unauthorized | Invalid or missing API key |
| 404 | Not Found | No results found for the given postal code and country |
| 422 | Validation Error | Validation error (country_code or postal_code 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 |
|---|---|---|
| [].locality_id | integer | Unique locality identifier |
| [].locality_name | string | Name of the locality |
| [].name_and_county | string | Combined locality and county name |
| [].county_name | string | County name |
| [].county_code | string | County code abbreviation |
| [].street_name | string | Street name for the postal code |
Response Example
RESPONSEJSON
[
{
"locality_id": 13893,
"locality_name": "Sector 3",
"name_and_county": "Bucuresti (Sector 3)",
"county_name": "Bucuresti",
"county_code": "B",
"street_name": "Bulevardul Unirii"
}
]Complete API Reference
For interactive testing and additional technical details, visit our complete Swagger documentation.
View in Swagger Documentation
