Loading
Loading
Look up location data for any ZIP or postal code worldwide. Returns city, region, country, coordinates, and locality for the given code. Optionally limit search to a specific country using an ISO 3166-1 alpha-2 country code.
Supports global postal systems including USPS, Royal Mail PAF, Canada Post, India Post, Japan Post, and more. Pass format=xml to receive an XML response instead of JSON.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The code parameter is required. The country parameter is optional but recommended to narrow results to a specific country.
coderequiredstringdefault: ZIP or postal code to look up. Only one code per request.
countryoptionalstringLimits search to a specific country. Must be in ISO 3166-1 alpha-2 format (e.g., US, GB). If not provided, searches all countries.
formatoptionalstringdefault: jsonResponse format: 'json' (default) or 'xml'.
A successful request returns a 200 OK with a JSON object containing a results array. Each element represents a matched postal code location.
resultsArray of postal code result objects.
results[].codePostal / ZIP code of the location.
results[].country_codeCountry code in ISO 3166-1 alpha-2 format.
results[].regionRegion, state, or province associated with the postal code.
results[].region_codeRegion code or abbreviation.
results[].cityCity associated with the postal code.
results[].localityLocality or neighborhood associated with the postal code.
results[].latitudeLatitude coordinate of the postal code location.
results[].longitudeLongitude coordinate of the postal code location.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Only ISO 3166-1 alpha-2 codes country codes are supported.
Provided postal/zip code was not found in our database.