One code for the place. /nearby for the codes around it. /distance for miles between two.

Nine, each from its official national source. Listed below.

City, country name, state, district, coordinates, elevation, population, land and water area, timezone, US sales tax on sourced ZIPs, and the codes next door.

Does it include sales tax?

US ZIPs do, when the state is sourced. Combined highest rate in that ZIP. California and Texas are empty until those files land. Country and state carry the same two keys. The tax page covers all three.

Not when the code exists in exactly one covered country. SW1A 1AA and 100-0001 resolve bare. 33139 matches two countries, so that is a 404 asking for ?country=, never a guessed US ZIP. Country takes ISO2, ISO3, or a name.

The layer under the state. A US county FIPS, a French INSEE department, a GB GSS code. /district turns that code into a name.

The surrounding postal codes. Same idea as country borders, one layer down.

GET /postal/{code} · /nearby · /distance/{other}

ZIP code API

Pass a ZIP or postcode. City, district, area, timezone, and the codes next door.

You have a ZIP or postcode. City, district, tax.

city

Primary city name (English or romanized when available, native otherwise)

country_name

Country name

state

State or province code

district

District code when /district can resolve it for this country (US FIPS, FR INSEE, GB GSS). Null for Japan until JP districts are seeded

area

Total area in km² (null when the source has no water split)

population

Population estimate

timezone

Timezone identifier

tax

Levy name from the state (Sales tax, General excise tax). Null when the state levies none, or outside the US

tax_rate

Combined highest sales tax rate in this ZIP, percent. 0 where the state levies none. Null when unsourced

neighbors

Short list of surrounding postal codes (like country borders)

nearby

Postal codes within the radius, with distance and distance_mi

distance

Straight-line distance in km

distance_mi

Straight-line distance in miles

Pass the code

Unique codes resolve bare. Five-digit codes often need ?country=.

Get the place

Readable name first. Native sibling when it differs. Land and water area where the source has them.

Nearby and distance

Miles and kilometers on every plan where we have coords.

1.9 million codes.

Nine countries. Official sources.

9
countries: 33k+
US ZIP codes: 1.7M+
UK unit postcodes

Convert a ZIP or postal code into city, state, district, area, timezone, population, and coordinates. Unique codes resolve bare: SW1A 1AA, 100-0001. Five-digit codes often collide across the US, France, and Mexico. That is a 404 asking for ?country=, never a guessed US ZIP. Country takes ISO2, ISO3, or a name.

city reads in English or an official romanization when available, so a Tokyo postcode returns Chiyoda Ku. Japan pairs it with city_local, the native form (千代田区). Land and water area ship where the source has them. US rows also carry combined sales tax when the state is sourced.

Nine countries, each from its official national source. Distance and nearby results (miles and kilometers) are included on every plan for countries that ship coordinates.

RESPONSE

$ curl "https://api.parseapi.com/postal/33139?country=US" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~38ms US · ~101ms worldwide
{
  "postal": "33139",
  "city": "Miami Beach",
  "city_local": null,
  "district": "12086",
  "district_name": "Miami-Dade",
  "district_name_local": null,
  "state": "FL",
  "state_name": "Florida",
  "state_name_local": null,
  "country": "US",
  "country_name": "United States",
  "latitude": 25.779391,
  "longitude": -80.151566,
  "elevation": 6,
  "elevation_ft": 20,
  "population": 33753,
  "area": 15.3,
  "land_area": 7.21,
  "water_area": 8.09,
  "timezone": "America/New_York",
  "currency": "USD",
  "tax": "Sales tax",
  "tax_rate": null,
  "tax_rate_state": null,
  "tax_rate_county": null,
  "tax_rate_city": null,
  "tax_rate_special": null,
  "neighbors": [
    "33132",
    "33109",
    "33131",
    "33137",
    "33140",
    "33101",
    "33128",
    "33130"
  ]
}

Response fields

postal: Postal or ZIP code
city: Primary city name (English or romanized when available, native otherwise)
city_local: Native city name (null when absent or same as city). Read city_local ?? city for the original-script form
district: District code when /district can resolve it for this country (US FIPS, FR INSEE, GB GSS). Null for Japan until JP districts are seeded
district_name: District / ADM2 name (English or romanized when available, native otherwise)
district_name_local: Native district name (null when absent or same as district_name)
state: State or province code
state_name: State or province name (English or romanized when available, native otherwise)
state_name_local: Native state or province name (null when absent or same as state_name)
country: ISO2 country code
country_name: Country name
latitude: Approximate latitude
longitude: Approximate longitude
elevation: Elevation in meters
elevation_ft: Elevation in feet
population: Population estimate
area: Total area in km² (null when the source has no water split)
land_area: Land area in km² (null where the source has none)
water_area: Water area in km² (null where the source has none)
timezone: Timezone identifier
currency: ISO currency code for the country
tax: Levy name from the state (Sales tax, General excise tax). Null when the state levies none, or outside the US
tax_rate: Combined highest sales tax rate in this ZIP, percent. 0 where the state levies none. Null when unsourced
tax_rate_state: State piece of the combined rate, percent. Null when that level does not apply
tax_rate_county: County piece of the combined rate, percent. Null when that level does not apply
tax_rate_city: City piece of the combined rate, percent. Null when that level does not apply
tax_rate_special: Special district piece of the combined rate, percent. Null when that level does not apply
neighbors: Short list of surrounding postal codes (like country borders)

QUESTIONS

When do I use which?: One code for the place. /nearby for the codes around it. /distance for miles between two.
Which countries?: Nine, each from its official national source. Listed below.
What comes back?: City, country name, state, district, coordinates, elevation, population, land and water area, timezone, US sales tax on sourced ZIPs, and the codes next door.
Does it include sales tax?: US ZIPs do, when the state is sourced. Combined highest rate in that ZIP. California and Texas are empty until those files land. Country and state carry the same two keys. The tax page covers all three.
Do I need a country?: Not when the code exists in exactly one covered country. SW1A 1AA and 100-0001 resolve bare. 33139 matches two countries, so that is a 404 asking for ?country=, never a guessed US ZIP. Country takes ISO2, ISO3, or a name.
What is a district?: The layer under the state. A US county FIPS, a French INSEE department, a GB GSS code. /district turns that code into a name.
What are neighbors?: The surrounding postal codes. Same idea as country borders, one layer down.
Do nearby and distance ship?: Yes, in miles and kilometers, on every plan where we have coordinates.

SPEED

How long /postal takes.

14ms

17ms

APAC

54ms

LatAm

14ms

116ms

See live status →

Coverage

Nine countries, each from its official national source.

United States
Mexico
United Kingdom
France
Switzerland
Liechtenstein
Denmark
Japan
Australia

Contains OS data (c) Crown copyright and database right 2026. Postal area data from the Australian Bureau of Statistics, CC BY 4.0. French data from Etalab under Licence Ouverte 2.0. Swiss and Liechtenstein data from swisstopo (OGD). Mexican catalog under Libre Uso MX (Correos de México). Danish data from Klimadatastyrelsen (Danmarks Adresser).

Look up a ZIP, every ZIP in a radius, or the distance between two.

Get started Docs