The free open source static API for all the worlds postal codes.

See zippopotam.us for how to use the API.

Please correct any mistakes or add any new countries that we are missing by editing

raw/allCountries.txt : Tab Delimited Dump of All Countries Postal Codes from geonames.org

If adding a new country, you need to add a new line to:

raw/country.txt : Tab Delimited file, 2-Letter ISO Country code and Country Name

The data format is tab-delimited text in utf8 encoding, with the following fields :

• country code : iso country code, 2 characters
• postal code : varchar(20)
• place name : varchar(180)
• admin name1 : 1. order subdivision (state) varchar(100)
• admin code1 : 1. order subdivision (state) varchar(20)
• admin name2 : 2. order subdivision (county/province) varchar(100), Ignored API
• admin code2 : 2. order subdivision (county/province) varchar(20), Ignored by API
• admin name3 : 3. order subdivision (community) varchar(100), Ignored by API
• admin code3 : 3. order subdivision (community) varchar(20), Ignored by API
• latitude : estimated latitude (wgs84)
• longitude : estimated longitude (wgs84)
• accuracy : accuracy of lat/lng from 1=estimated to 6=centroid Ignored by API

Submit an issue or contact Jeff or Samir

© Jeff Crowell - Samir Ahmed 2012