Loading
Loading
Look up location data for up to 100 ZIP or postal codes in a single POST request. Returns city, region, country, coordinates, and locality for each code.
Send a JSON body with a codes array (max 100) and an optional country field to limit lookup to a specific country. Each matched code returns the same fields as the single lookup endpoint.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
Send a JSON body with the following fields:
codesArray of ZIP or postal code strings to look up. Maximum 100 per request.
countryLimit lookup to a specific country. Must be in ISO 3166-1 alpha-2 format.
The request body must be a JSON object containing a codes array of postal codes and a country code.
{
"codes": [
"10001",
"90210"
],
"country": "US"
}A successful request returns 200 OK with a results array containing one object per matched postal code.
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.
A maximum of 100 postal/zip codes can be processed per request.
None of the provided postal/zip codes were found in our database.