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.
Optional query parameter to control the response format.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
The request body must be a JSON object containing a codes array of postal codes and a country code.
{
"codes": [
"10001",
"90210"
],
"country": "US"
}codesrequiredArray<String>Array of ZIP or postal code strings to look up. Maximum 100 per request.
countryoptionalStringLimit lookup to a specific country. Must be in ISO 3166-1 alpha-2 format.
A successful request returns 200 OK with a results array containing one object per matched postal code.
To see the complete response structure, ZIP Code Lookup API.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
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.