Look up a postal code
Resolve a postal/ZIP code to its place name, administrative regions, and coordinates. Covers ~100 countries (GeoNames). Coordinates are approximate and a few countries have reduced precision.
Resolve a postal/ZIP code to its place name, administrative regions, and coordinates. Covers ~100 countries (GeoNames). Coordinates are approximate and a few countries have reduced precision.
Path Parameters
ISO 3166-1 alpha-2 country code.
Postal / ZIP code.
Response Body
application/json
text/plain
curl -X GET "https://example.com/postal/US/10001"[ { "countryCode": "US", "postalCode": "10001", "placeName": "New York City", "admin1": { "name": "New York", "code": "NY" }, "admin2": { "name": "string", "code": "string" }, "latitude": 40.7484, "longitude": -73.9967, "accuracy": 4 }]"Country not found"Search all places GET
Search the full GeoNames gazetteer — ~12M features worldwide (cities, towns, mountains, rivers, regions and more), ordered by population. Filter by name (`q`), `country`, and feature `class`. Also: `GET /places/{geonameId}` for one place and `GET /places/near?lat=&lng=` for the nearest features to a coordinate.
Filter countries by region GET
Returns every country in the given region (exact match, case-insensitive).