PostalCodes

Geocoding

Visit website

Global postal code search, country exports and address validation data.

About PostalCodes

PostalCodes.info provides access to postal code data covering 123 countries, with records for postal codes, place names, country codes, administrative regions, and coordinates. Data is sourced from GeoNames. Access is provided through a same-origin search endpoint for autocomplete-style queries, token-protected country-level exports in CSV, JSON, or XLSX format, and canonical HTML pages for individual postal codes. An OpenAPI specification is published at /openapi.json. There is no separate API subdomain; all access runs through the postalcodes.info domain.

The dataset totals 1,827,156 postal records, with 1,080,895 distinct postal code values and 888,760 mapped localities, and reports average coordinate coverage of 99.2% across country profiles. Coordinates are described as approximate centroids suitable for grouping, routing zones, or map previews rather than exact delivery points.

The service is intended for developers building address forms with locality autocomplete, enriching stored addresses with region and coordinate data, performing bulk validation by downloading and checking a country's data locally, and conducting manual QA on individual records through canonical pages. Guidance on the page recommends downloading country exports for batch validation rather than calling the live search endpoint per address, and treating postal codes as strings due to valid leading zeroes and spaces in some countries' formats.

Key features

Autocomplete postal code search via same-origin JSON endpoint
Token-protected country data exports in CSV, JSON and XLSX
Canonical HTML pages per postal code for manual QA and audit trail
Coverage across 123 countries with 1,827,156 postal records
OpenAPI specification available at /openapi.json
Average 99.2% coordinate (geocoding) coverage across country profiles

Frequently asked questions

Is there a separate API subdomain?

No, all access — canonical pages, exports and search — is served from postalcodes.info on the same host.

How is the data accessed — REST API or something else?

JSON is available through a site search endpoint and through download buttons that mint a same-origin token before exporting CSV, XLSX or JSON, rather than a traditional API host.

How many countries and records are covered?

The dataset covers 123 countries with 1,827,156 postal records and 1,080,895 distinct postal identifiers.

What should I use for batch validation versus interactive lookup?

Use a country JSON or CSV export for batch validation, and the /search endpoint with a country filter for interactive autocomplete lookup.

Where does the underlying data come from?

The data is powered by GeoNames and hosted on Oracle Cloud.

Advertise here