Postal codes worldwide
International postal code API
One request format for postal codes everywhere, from US ZIP codes and UK postcodes to Austrian, German or Canadian codes. The /v1/search endpoint returns the place, its administrative levels and coordinates for up to 100 codes at once.
Example request and response
The /v1/search endpoint, with the example from the documentation. Pass country to look a code up in one country.
curl -G "https://api.zipcodestack.com/v1/search?codes=1010&country=AT" \
-H "apikey: YOUR-API-KEY"
{
"query": { "codes": ["1010"], "country": "AT" },
"results": {
"1010": [
{
"postal_code": "1010",
"country_code": "AT",
"latitude": 48.2077,
"longitude": 16.3705,
"city": "Wien, Innere Stadt",
"state": "Wien",
"city_en": "Wien, Innere Stadt",
"state_en": "Wien",
"state_code": "09",
"province": "Wien Stadt",
"province_code": "900",
"community": "Wien, Innere Stadt",
"community_code": "90101",
"accuracy": 4
}
]
}
}
Response fields
| Field | What it contains |
|---|---|
| city, state, state_code | The place and the first administrative level (a US state, a German or Austrian Bundesland). city_en and state_en hold the English names where they differ. |
| province, province_code | The second level, for example a US county or a German Landkreis; null where the country has none. |
| community, community_code | The third level, for example a municipality, where the country has one. |
| latitude, longitude, accuracy | The coordinates and how precise they are: 1 estimated, 4 geocoded place, 6 centroid of the addresses in the code. |
Use cases
International checkout
Fill in the city and region from the postal code in every market you ship to, with one integration.
Data enrichment
Add region, county and coordinates to customer and order records for reporting and maps.
Bulk lookups
Send up to 100 codes per request; you pay one credit per code that is found.
Start on the free plan
The search endpoint costs 1 credit per postal code found. The free plan includes 300 credits a month with 10 requests a minute; paid plans start at $34.99 a month for 70,000 credits.
Frequently asked questions
Which countries are covered?
Can one postal code belong to several places?
results holds a list of matches for each code.How do I check a code a customer typed?
/v1/validate, described on the postal code validation API page: it also tells you whether the code has the country's format.