Postal Codes API - Access to Worldwide Postal Code Data

Lookup postal codes, get all postal codes range distance and much more with our postal code API.

World wide Data

94+ Countries

View pricing

Read documentation

{
   "query":{
      "code": "10005",
      "country": "US",
      "range": "25",
      "measure": "km",
   },
   "results":{
       "range_codes_unique": [
           "07010", 
           "07020", 
           "07022", 
           "07024", 
           "07026", 
           ...
       ],
       "range_codes": [
           "07010", 
           "07020", 
           "07022", 
           "07024", 
           "07026", 
           ...
       ],
       "range_codes_details": [
          {
              "postal_code":"07010",
              "country_code":"US",
              "city":"Cliffside Park",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07020",
              "country_code":"US",
              "city":"Edgewater",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07022",
              "country_code":"US",
              "city":"Fairview",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07024",
              "country_code":"US",
              "city":"Fort Lee",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07026",
              "country_code":"US",
              "city":"Garfield",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
           ...
       ],
   }
}

Easy to use API

PostalCodes.app is a tool that allows you to obtain information on different postal codes around the world. You can get postal codes in a distance range in kilometers or miles, or get the details of a postal code in general.

GET Get postal codes within a distance

With this easy to use endpoint you will get a list of Postal codes that are within a given distance. The request example will return a list of unique postal codes, a complete list of postal codes and the details of each postal code.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&distance=25&zipcode=10005&country=us

Our API accepts distance measurements in kilometers (Default) or miles.

To change measurement to miles you must put the ms parameter in your request:

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&ms=mi&distance=25&zipcode=10005&country=us

The response will look like this:

{
   "query":{
      "code": "10005",
      "country": "US",
      "range": "25",
      "measure": "km"
   },
   "results":{
       "range_codes_unique": ["07010", "07020", "07022", "07024", "07026", ...],
       "range_codes": ["07010", "07020", "07022", "07024", "07026", ...],
       "range_codes_details": [
          {
              "postal_code":"07010",
              "country_code":"US",
              "city":"Cliffside Park",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07020",
              "country_code":"US",
              "city":"Edgewater",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07022",
              "country_code":"US",
              "city":"Fairview",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07024",
              "country_code":"US",
              "city":"Fort Lee",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07026",
              "country_code":"US",
              "city":"Garfield",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
           ...
       ],
   }
}

GET Get postal codes details

The following example will return the details of the postal codes that match with the search query.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&zipcode=10005&country=us

The response will look like this:

{
   "query":{
      "code": "10005",
      "country": "us",
      "range": "",
      "measure": "km"
   },
   "results":{
       "range_codes_unique": ["10005"],
       "range_codes": ["10005"],
       "range_codes_details": [
          {
              "postal_code":"10005",
              "country_code":"US",
              "city":"New York",
              "state":"New York",
              "state_code":"NY",
              "province":"New York",
              "province_code":"061"
          }
       ],
   }
}

GET Get custom data

You can pass extra params to get only what you need in the results, just add the value fields in your request.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&fields=["range_codes_unique"]&distance=25&zipcode=10005&country=us

The response will look like this:

{
   "query":{
      "code": "10005",
      "country": "US",
      "range": "25",
      "measure": "km"
   },
   "results":{
       "range_codes_unique": ["07010", "07020", "07022", "07024", "07026", ...]
   }
}

+94 Supported countries

AD (Andorra)

AR (Argentina)

AS (American Samoa)

AT (Austria)

AU (Australia)

AX (Aland Islands)

AZ (Azerbaijan)

BD (Bangladesh)

BE (Belgium)

BG (Bulgaria)

BM (Bermuda)

BR (Brazil)

BY (Belarus)

CA (Canada)

CH (Switzerland)

CL (Chile)

CO (Colombia)

CR (Costa Rica)

CY (Cyprus)

CZ (Czech Republic)

DE (Germany)

DK (Denmark)

DO (Dominican Republic)

DZ (Algeria)

EE (Estonia)

ES (Spain)

FI (Finland)

FM (Micronesia)

FO (Faroe Islands)

FR (France)

GB (United Kingdom)

GF (French Guiana)

GG (Guernsey and Alderney)

GL (Greenland)

GP (Guadeloupe)

GT (Guatemala)

GU (Guam)

HR (Croatia (Hrvatska))

HU (Hungary)

IE (Ireland)

IM (Man (Isle of))

IN (India)

IS (Iceland)

IT (Italy)

JE (Jersey)

JP (Japan)

KR (Korea South)