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 the source has one, so a Tokyo postcode returns Chiyoda Ku. Japan pairs it with city_local, the native form (千代田区).

Every country comes straight from its official national source. Distance and nearby results (miles and kilometers) are included on every plan.

1.9M+
postal codes: 5
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 · ~14ms · 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. Not a lab benchmark. The whole trip.

14ms

18ms

APAC

45ms

LatAm

18ms

126ms

See live status →

Coverage

Five countries, each from its official national source.

United States
United Kingdom
Japan
France
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.

Create a free key Docs