APIs/Postal

Postal API

GET /postal/{code}?country={iso2}

Convert a postal or ZIP code into city, state, and coordinates. One response shape across every covered country. 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 (千代田区).

Distance and nearby results (miles and kilometers) are included on every plan for countries that ship coordinates.

1.9M+
postal codes: 9
countries: 1.7M+
UK unit postcodes: 100%
official sources

Try itcountry=US

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

// 200 · ~15ms · USA
{
  "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",
  "latitude": 25.7823,
  "longitude": -80.1375,
  "elevation": 1,
  "elevation_ft": 3,
  "population": 38000,
  "timezone": "America/New_York",
  "currency": "USD",
  "neighbors": [
    "33140",
    "33141",
    "33154",
    "33160",
    "33109"
  ]
}

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
latitude: Approximate latitude
longitude: Approximate longitude
elevation: Elevation in meters
elevation_ft: Elevation in feet
population: Population estimate
timezone: Timezone identifier
currency: ISO currency code for the country
neighbors: Short list of surrounding postal codes (like country borders)

SPEED

Fast from everywhere.

Median time for a /postal response to reach a real city, first byte back, measured live from 16 cities.

15ms

17ms

APAC

45ms

LatAm

19ms

125ms

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).

Create a free key Docs