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 (LINZ, Stats NZ) 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-nz-sample
| Field | Type | Description | Constraints | Title |
|---|---|---|---|---|
| country_code | string | ISO 3166-1 country code — always NZ | { "pattern": "^NZ$", "required": true } | Country Code |
| postal_code | string | Four-digit New Zealand postcode (leading zeros significant) | { "pattern": "^\\d{4}$", "required": true } | Postal Code |
| place_name | string | Representative locality / suburb | Place Name | |
| admin_name1 | string | Region (one of the 16 NZ regions) | Administrative Name 1 | |
| admin_code1 | string | ISO 3166-2:NZ region code | Administrative Code 1 | |
| admin_name2 | string | Territorial authority — official Stats NZ 2025 name | Administrative Name 2 | |
| admin_code2 | string | Stats NZ Territorial Authority 2025 code (3-digit) | Administrative Code 2 | |
| admin_name3 | string | Reserved — not populated for New Zealand | Administrative Name 3 | |
| admin_code3 | string | Reserved — not populated for New Zealand | Administrative Code 3 | |
| latitude | number | Latitude (WGS84, decimal degrees) — LINZ centroid where available | Latitude | |
| longitude | number | Longitude (WGS84, decimal degrees) — LINZ centroid where available | Longitude | |
| accuracy | string | Reserved — not populated for New Zealand | Accuracy | |
| alternative_city_name | string | Pipe-separated additional localities sharing the postcode | Alternative City Name |
Download
Download sample CSVAbout
- Last updated
- 9 October 2026
- Total rows
- 100
- Format
- CSV
- File size
- 8.22 kB
- Sources
- LINZ NZ Addresses (Toitū Te Whenua Land Information New Zealand)
- LINZ NZ Addresses, LINZ's public ArcGIS Online feature service (read by the producer)
- Stats NZ Territorial Authority 2025
- Stats NZ Territorial Authority 2025, public ArcGIS feature service (read by the producer)
- New Zealand postcodes (community, public domain)
About this dataset
Postal Codes Dataset for New Zealand (NZ)
This dataset lists New Zealand's four-digit postcodes, one row per postcode, with the place
name, region, territorial authority and coordinates. Other localities that share a postcode are
listed in alternative_city_name.
Column definitions, row count, size and last-updated date are in datapackage.yaml.
Data Sources
- Postcode list, place names, regions, community territorial-authority names and coordinates: New Zealand postcodes compiled by Matthew Proctor, public domain.
- Address-based coordinates: © Toitū Te Whenua Land Information New Zealand (LINZ), NZ Addresses, CC BY 4.0.
- Territorial authority names and codes: © Stats NZ, Territorial Authority 2025, CC BY 4.0.
Changes made to the source data: one row per postcode (first community row kept, other localities
for the postcode moved to alternative_city_name); region codes mapped to ISO 3166-2:NZ; LINZ address
points reduced to one centroid per locality; territorial-authority names and codes standardised to
Stats NZ 2025 names and codes.
Not endorsed by, or affiliated with, Matthew Proctor, LINZ or Stats NZ.
Known limitations
- The postcode list itself is community-compiled: NZ Post licenses its postcode file commercially.
- A row takes the LINZ centroid and Stats NZ territorial authority only when the locality's territorial authority lies in the row's region; otherwise the community name (standardised to the Stats NZ name and code) and community coordinates are kept.
- LINZ centroids ignore points outside the main islands (for example the Chatham Islands) and are rounded to 6 decimal places.
admin_name3,admin_code3andaccuracyare always empty.
Usage
The dataset files are available in CSV format and can be accessed and downloaded using
the links provided in datapackage.yaml. Read postal_code as text, never as a number:
New Zealand codes can start with zero (0114).
For other inquiries, contact datahub@datopian.com