World Postal Code directory
Find any postal code by country, city, address, map click, or your current location.
Browse a complete country index with flags, search launch seed data instantly, and use map-based reverse lookup without needing paid provider setup locally.
250 countries and territoriesOpenStreetMap tilesNominatim geocoding
Address and postal lookup
Country-aware search for codes, cities, regions, aliases, and normalized postcode formats.
Click-to-reverse map
Drop a marker anywhere and show a WorldPostalCode-style postal information panel.
Precise current location
Prompt for browser location, mark the detected point, and show nearby postal-code details.
All postcodes
Browse postal codes by country
A complete country index grouped by continent. Launch countries open full seed directories; every other country opens a lookup and map landing page while data coverage expands.
250 countries and territories
250 matching countries and territories
Americas
56 countriesAntarctica
5 countriesAsia
50 countriesEurope
53 countriesOceania
27 countriesPostal code guides
How to find a postal code
Search by address, city, state, province, country, or click the map when you are unsure which administrative division to choose.
Map data and geocoding
Local MVP uses seed centroids and OpenStreetMap-style tiles; provider adapters keep TomTom, HERE, and Nominatim options open for production.
Current location lookup
The browser asks for permission, then the app places a marker and shows the nearest postal-code candidates without storing precise location.
Data quality
Correction reports and CSV validation are part of the workflow so coverage can expand beyond the launch seed records.
Developer preview
Postal-code API paths are already shaped for product use.
Internal MVP routes expose stable JSON for search, reverse lookup, countries, regions, postal-code details, reports, and CSV validation while provider adapters keep the local path free to run.
/api/search
Seed and Nominatim search
Country-aware ranked lookup for postal codes, localities, regions, and global address matches.
/api/reverse
Map reverse lookup
Latitude/longitude lookup for clicked, searched, or detected map points with provider attribution.
/api/reports
Correction reports
Local report intake with public-safe previews and rate limiting for data-quality workflows.
/api/admin/import/validate
CSV validation
Pre-import checks for country, region, locality, postal-code format, coordinates, and duplicates.
Postal code FAQ
Can I browse every country?
Yes. The homepage directory lists every country and territory with flags, grouped by continent. Seven launch countries include seed-backed postal-code tables today.
What happens outside the seed countries?
Unsupported countries still open country landing pages, lookup, and map flows. Nominatim can return real address or postcode data when available; seed candidates stay scoped to the provider country.
Does current location store precise coordinates?
No persistence is added in the MVP. Browser coordinates are used in the active session to place the marker, draw accuracy, and call reverse lookup.
Why can a postal code be unavailable?
Some providers return an address without a postcode, and the MVP avoids guessing from distant seed records. Nearby seed candidates are shown only when they are relevant.