List of World Zip Codes / Postal Codes

This is a comprehensive database with data about the post office codes for all countries in the world. Each dataset represents a country and has the following information available.

• Zip Code Number in a String format
• Place Name in a String format
• Geolocation in a Geopoint format
• Geolocation Accuracy in a String format
• Admin Code in a String format
• Admin Name in a String format

Let's consider a Zip Code from Australia as an example. The data provided will look like this:

• Zip Code Number: 0200
• Place Name: Australian National University
• Geolocation: (-35.2777, 149.1189)
• Geolocation Accuracy: 1
• Admin Code in a String format: ACT
• Admin Name in a String format: Australian Capital Territory

Last Update

February, 26, 2020

Data Source

This database was extracted from http://www.geonames.org/.

License

This work is licensed under a Creative Commons Attribution 4.0 License.

Database Definitions

• 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)
• admin code2 : 2. order subdivision (county/province) varchar(20)
• admin name3 : 3. order subdivision (community) varchar(100)
• admin code3 : 3. order subdivision (community) varchar(20)
• latitude : estimated latitude (wgs84)
• longitude : estimated longitude (wgs84)
• accuracy : accuracy of lat/lng from 1=estimated, 4=geonameid, 6=centroid of addresses or shape

Designed for developers

Easy to use API available! Using this database a developer is able to:

• Consume the API in a REST or GraphQl format
• Connect any application to the database
• Clone and make changes to the database

Benefits for a developer

• Read to use data available
• Insert data on autocomplete forms
• One API Key is able to connect to multiple data sources
• Receive regular data updates

Get Started and Fetch Data

• NodeJS - Fetch Data with Node JS Code
• JavaScript - Fetch Data with Java Script Code
• Swift - Fetch Data with Apple Swift Code
• Objective-C - Fetch Data with Apple Objective-C Code
• Kotlin on Android - Fetch Data with Kotlin on Android
• Kotlin - Fetch Data with Kotlin
• Java on Android - Fetch Data with Java on Android
• PHP - Fetch Data with PHP
• Python - Fetch Data with Python
• Java - Fetch Data with Java

Query Examples

Example 1: List all Zip Codes in Denmark

You need to go to the API Playground and perform a query like this one:

query allDKS {
      dKS (skip: 0, limit: 3) {
        results {
          ACL
          accuracy
          adminCode1
          adminCode2
          adminCode3
          adminName1
          adminName2
          adminName3
          countryCode
          createdAt
          geoPosition {
            latitude
            longitude
          }
          id
          placeName
          postalCode
          updatedAt
        }
      }
    }

The result will be:

{
  "data": {
    "dKS": {
      "results": [
        {
          "ACL": null,
          "accuracy": "6",
          "adminCode1": "18",
          "adminCode2": "615",
          "adminCode3": "",
          "adminName1": "Region Midtjylland",
          "adminName2": "Horsens Kommune",
          "adminName3": "",
          "countryCode": "DK",
          "createdAt": "2020-02-21T13:12:51.587Z",
          "geoPosition": {
            "latitude": 55.7573,
            "longitude": 10.271
          },
          "id": "MqO7xFz8Ls",
          "placeName": "Endelave",
          "postalCode": "8789",
          "updatedAt": "2020-02-21T13:12:51.587Z"
        }
      ]
    }

Example 2: Count all Zip Codes in Switzerland

The query will look like this:

query countCHES {
      ches {
        count
      }
    }

The result will be:

{
  "data": {
    "ches": {
      "count": 4356
    }
  }
}

FAQ – Frequently Asked Questions

How can I get an API key?

Getting a key is a simple and straightforward process. Please refer to the Connect Button on the top right hand side of this page. The process has 3 steps:

• Login
• Add a name to your app
• Connect and get the API key

Takes less than 1 minute.

Can I use the same API Key for multiple databases?

Yes, you can integrate several databases under the same API Key.

What can I get for free?

You can use the database for free up to 10k requests per month. More details in our Pricing Page.

What is an API request?

Every moment you execute a call to the database in the name of an application using a SDKs or an API, it counts as an API request. Logins, saves, queries are examples of operations calculated as API requests, among other types of operations.

What API types are supported?

The service works with two different API protocols:

• GraphQL
• REST

You can make queries, access, and retrieve data from a public dataset via a GraphQL API. If you clone the database, it’s possible to work with REST or GraphQL APIs.

What SDKs and Libraries are supported?

The list is pretty broad and the most common ones are:

• iOS
• Android
• Javascript
• Unity

What is Back4app?

Back4app is a BaaS Platform and will support you in facilitating the development and making great apps faster vs. a custom backend.

Please see below other popular databases:

• List of Continents, Countries, States, and Cities
• US Zip Codes
• Brazil Zip Codes