Lookup · Nearby · Distance
Postal Code API
Fill city and state.
Find places nearby.
Get city, state, timezone and coordinates where available. Compare two postal locations in miles or kilometers.
Try a postal code
SW1A1AA
City of Westminster
England · United Kingdom
- District
- City of Westminster
- Timezone
- Europe/London
Complete JSON
{
"postal": "SW1A1AA",
"city": "City of Westminster",
"city_local": null,
"localities": null,
"district": "E09000033",
"district_name": "City of Westminster",
"district_name_local": null,
"state": "ENG",
"state_name": "England",
"state_name_local": null,
"country": "GB",
"country_name": "United Kingdom",
"latitude": 51.501009,
"longitude": -0.141588,
"timezone": "Europe/London"
}Lookup, nearby and distance
Postal data.
Ready for your app.
Look up a code, find nearby codes, or compare two locations. Complete JSON for every request.
curl "https://api.parseapi.com/postal/10001?country=US" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Parse-Version: 2.0.0"// Example response · 200
{
"postal": "10001",
"city": "New York",
"city_local": null,
"localities": null,
"district": "36061",
"district_name": "New York",
"district_name_local": null,
"state": "NY",
"state_name": "New York",
"state_name_local": null,
"country": "US",
"country_name": "United States",
"latitude": 40.750649,
"longitude": -73.997298,
"timezone": "America/New_York"
}Less typing in your forms
A little less typing.
Fill the city and state from a postal code. Keep the fields editable. Your customer finishes the address.
Add ZIP code autofillZIP code
10001
City
New York
State
NY
City and state from the 10001 example. Keep customer input editable.
Locations around a place
Find places.
Know the distance.
Build a store locator, group a service area, or compare two postal locations. Choose a radius or get the distance in miles and kilometers.
Distances are straight-line measurements between postal reference points, where available.
Build a store locatorExample response
Charlotte
28202
New York
10001
533.19 miles
858.08 kilometers · Straight-line distance
Complete JSON response
/postal/28202/distance/10001?country=US
{
"country": "US",
"postal": "28202",
"city": "Charlotte"
},
"postal": "10001",
"city": "New York"
},
"distance": 858.08,
"distance_mi": 533.19
}Optional place detail
Simple first.
More when you need it.
Add deep=true for population, area and regional detail in the same request.
Deep is available on paid plans.
- Population and area
- Population with its observation period, land and water area, and elevation.
- US regional detail
- Metropolitan associations and ZIP tax references where known. Exact-address tax can differ.
This product uses the HUD User Data API but is not endorsed or certified by HUD User.
Coverage and confidence
The places we cover.
55 countries and territories. Available fields and completeness vary by country.
- United States
- Mexico
- United Kingdom
- France
- Switzerland
- Liechtenstein
- Denmark
- Japan
- Australia
- Austria
- Norway
- Finland
- Luxembourg
- Czechia
- Belgium
- Netherlands
- Slovenia
- Latvia
- Hungary
- Iceland
- Estonia
- Lithuania
- Malaysia
- Cyprus
- Mauritius
- Slovakia
- South Korea
- Colombia
- Uruguay
- Spain
- Italy
- Portugal
- Croatia
- Bulgaria
- Costa Rica
- Sri Lanka
- Nepal
- Brazil
- Faroe Islands
- Monaco
- Morocco
- Peru
- North Macedonia
- Moldova
- Albania
- Guernsey
- Jersey
- Isle of Man
- Åland
- Svalbard and Jan Mayen
- Puerto Rico
- US Virgin Islands
- Guam
- Northern Mariana Islands
- American Samoa
Missing values return null. Enter postal codes for nearby and distance. We use their stored location data where available.
Country details
- Australia
- Suburb choices for 2,634 geographic postcodes from August 2026. 694 have an unambiguous city for autofill; other codes keep city null. Each choice includes its state. Coordinates remain approximate postal-area locations.
- Albania
- 532 published codes. Postal destination names where unambiguous. Approximate postal-area coordinates for 383 codes.
- Brazil
- Codes recorded in the 2022 census, with approximate coordinates from address locations.
- Colombia
- Coordinates describe postal areas published in 2013.
- Croatia and Bulgaria
- Selected geographic postal codes with coordinates. Locality names return null.
- Faroe Islands
- Approximate village centres for mapped postal codes.
- Guernsey, Jersey, and Isle of Man
- 11,106 active codes from August 2026, with country, timezone, and currency. Names are unavailable. Jersey has approximate coordinates for 42 codes, from facility locations recorded in 2018; other codes have no coordinates.
- Italy
- Geographic postal points without locality names. Special and newly issued codes may be missing.
- Lithuania
- Eight counties, excluding Vilnius and Utena in the current edition.
- Malaysia, South Korea, Costa Rica, Sri Lanka, and Slovenia
- Names without coordinates.
- Mauritius
- Main island only. Names without coordinates.
- Mexico
- Available coordinates describe matched business locations.
- Moldova
- 1,063 ordinary office codes. Locality and region names where the served areas agree. No coordinates.
- Monaco
- The ordinary code 98000. Names without coordinates.
- Morocco
- 1,666 locality codes from September 2018, with city and province names. Neighborhood codes and southern postal regions are excluded. No coordinates.
- Nepal
- Current five-digit municipality and seven-digit ward codes. Names without coordinates.
- Netherlands
- Full six-character codes from geographic and address references. Locality names where unambiguous. Some address-reference codes have no coordinates.
- North Macedonia
- 202 corroborated codes. Postal destination names where the published names agree. No coordinates.
- Peru
- 2,669 published codes from March 2018. Locality, province, and department names where unambiguous. Approximate locality-based coordinates for 2,129 codes; several urban codes may share a point.
- Portugal
- Locality names where the published postal name agrees. Geographic coordinates. Special and newly issued codes may be missing.
- Spain
- Locality and administrative names where unambiguous.
- United Kingdom
- England, Scotland, and Wales, plus Northern Ireland postcodes with observed premises locations.
- United States and US territories
- Select US, PR, VI, GU, MP, or AS explicitly. Postal identities and geographic coverage differ; some valid ZIPs have no coordinates, city, or district. A lookup does not verify address delivery.
- Uruguay
- 121 postal areas with coordinates. Locality and department names where the address records agree.
From the first request to your app
One integration.
Room to do more.
Start with a postal lookup. Use the same key for nearby codes and distances, alongside the other ParseAPI products your app needs.
HTTP, SDKs and MCP
Copy a request above, then follow the reference for parameters, complete responses and errors. Use the existing Postal methods in your language or connect through MCP.
- JavaScript
- Python
- Go
- Ruby
- PHP
- Rust
- Swift
- Kotlin
Before you build.
What can I build with Postal?
Fill city and state from a postal code, put a location on a map, schedule in its timezone, or find nearby postal codes for a store locator. Fields vary by country.
Should I send a country?
Send the two-letter country code when you know it. A code shared by several covered countries requires a country. For example, use country=JP for 100-0001. A unique code can resolve on its own.
Can I choose an Australian suburb?
Yes. localities lists suburb and state choices. Keep those choices editable and let the customer choose. city is returned only when the geographic reference has one unambiguous city.
Does a ZIP lookup verify an address?
A ZIP lookup provides postal geography. Street address, apartment and deliverability verification are separate tasks.
What do the distances measure?
Straight-line distances between postal reference points, in kilometers and miles. Nearby returns postal codes inside your radius. Road distance and travel time require a routing service.
What does Deep add?
On a paid plan, deep=true adds population and its period, area, elevation, tax references, neighbors and metropolitan associations where available. Deep uses your API request allowance.
How do I keep leading zeros?
Send and store postal codes as strings. A ZIP such as 00501 retains its leading zeros. Postal codes can also contain letters and spaces.
What happens when a value is unavailable?
Unavailable fields return null. A missing code returns 404. A country is required when the same code resolves in more than one covered country.
Postal API pricing
Start building.
Your API request allowance is shared across ParseAPI products.
Free
Start free
Try Postal with a free API key.
Room to grow
See plans
Choose the volume your app needs.