Part of a Data Solution
- Explore →
Postal Codes Solution
Every worldwide postal-code dataset in one bundle — the ultimate global reference for precise postal codes.
Premium
You're viewing a free sample
Get the complete dataset — all rows and files — delivered instantly after checkout, with lifetime access to the latest version.
- Secure checkout via Stripe
- Instant download after payment
- Lifetime access to the latest version
- Creative Commons Attribution 4.0 International (ABS Local Government Area component) license
API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.
Start with these files — they give you everything you need to understand and access the dataset.
- 1. Fetch datapackage.yaml to inspect schema and resources
- 2. Download data resources listed in datapackage.yaml
- 3. Read README.md for full context
Data Files
postal-codes-au-sample
| Field | Type | Description | Constraints | Title |
|---|---|---|---|---|
| country_code | string | ISO 3166-1 country code — always AU | { "pattern": "^AU$", "required": true } | Country Code |
| postal_code | string | Four-digit Australian postcode (leading zeros significant) | { "pattern": "^\\d{4}$", "required": true } | Postal Code |
| place_name | string | Representative locality (most common in the postcode) | Place Name | |
| admin_name1 | string | State / territory name | Administrative Name 1 | |
| admin_code1 | string | State / territory abbreviation (NSW/VIC/QLD/SA/WA/TAS/NT/ACT/OT) | Administrative Code 1 | |
| admin_name2 | string | Local Government Area (LGA) name | Administrative Name 2 | |
| admin_code2 | string | ABS Local Government Area code | Administrative Code 2 | |
| admin_name3 | string | Reserved — not populated for Australia | Administrative Name 3 | |
| admin_code3 | string | Reserved — not populated for Australia | Administrative Code 3 | |
| latitude | number | Postcode centroid latitude (WGS84, decimal degrees) | Latitude | |
| longitude | number | Postcode centroid longitude (WGS84, decimal degrees) | Longitude | |
| accuracy | string | Reserved — not populated for Australia | Accuracy | |
| alternative_city_name | string | Pipe-separated additional localities sharing the postcode | Alternative City Name |
About this dataset
Australia (AU): migration notes
Internal record of the P5 migration. This is a dated record (2026-10-05) and is not shipped in the zip.
- Issue: pc-28e.7.4 (open, deferred)
- Producer: none written. The descriptor keeps
pipeline: producer: customwith refresh disabled, and the data stays as harvested from the live zip in09d7c89. - Parity: not run (no producer).
Why it stays on live data
- Live was built from G-NAF by a builder that is not in the repo. The in-repo
scripts/rebuild from Matthew Proctor's CSV instead. A producer ported from them (worktree commit7b590fa, not landed) changed 2,673 of 3,175 rows.- Correction 2026-10-06: live is Proctor-derived, not G-NAF. All 3,172 rows with coordinates match Proctor's
lat/long(see.licensing-notes.md). The 2,673-row diff must come from the ported producer's logic or upstream drift, not from a different source.
- Correction 2026-10-06: live is Proctor-derived, not G-NAF. All 3,172 rows with coordinates match Proctor's
- With no G-NAF builder to port, the no-producer-from-scratch rule applies.
Decisions
| Decision | By | Basis |
|---|---|---|
| Defer: stay on live data | User, 2026-10-03 | No G-NAF builder; rule: no producer from scratch |
Open questions
- Licensing mismatch, tracked in pc-9qt: there's no ATTRIBUTION.txt, and the descriptor says CC-BY-4.0 while
.licensing-notes.mdsays G-NAF EULA.- Resolved 2026-10-06 (pc-9qt, user decision): the data contains no G-NAF. Licence set to CC-BY-4.0 for the ABS LGA component, ATTRIBUTION.txt credits Proctor (public domain) and ABS ("Based on Australian Bureau of Statistics data"), and README Sources was added. Nothing was uploaded; au stays on live data (pc-5kk).
- Proctor's coordinates come from Australia Post's database, whose own file is commercially licensed. User decision 2026-10-06 (pc-93s): accept Proctor's public-domain position. Coordinates are kept and no extra attribution is added.
Provenance
Written 2026-10-05 from docs/parity/p5.md (batch sign-offs) and the bd notes on pc-28e.7.4.