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_codestringYesISO 3166-1 alpha-2 country code (e.g., "RO", "BG") - Path parameter
postal_codestringYesPostal code to lookup (e.g., "010099", "400001") - Path parameter

Response Codes

Code Status Description
200SuccessSuccessful operation
401UnauthorizedInvalid or missing API key
404Not FoundNo results found for the given postal code and country
422Validation ErrorValidation error (country_code or postal_code field required, invalid format, etc.)
429Too Many RequestsRate limit exceeded
500Internal Server ErrorAn unexpected error occurred

Response Format

Field Type Description
[].locality_idintegerUnique locality identifier
[].locality_namestringName of the locality
[].name_and_countystringCombined locality and county name
[].county_namestringCounty name
[].county_codestringCounty code abbreviation
[].street_namestringStreet 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