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.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis 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.