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 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.yml to inspect schema and resources
- 2. Download data resources listed in datapackage.yml
- 3. Read README.md for full context
Data Files
Postal Codes Data Resource for South Africa, ZA
| Field | Description | Title |
|---|---|---|
| country_code | ISO 3166-1 alpha-2 code for the country. | Country Code |
| postal_code | Postal code for the location. | Postal Code |
| place_name | Name of the city, town, or place. | Place Name |
| admin_name1 | Primary administrative division (e.g., state, region). | Administrative Name 1 |
| admin_code1 | Code for the primary administrative division. | Administrative Code 1 |
| admin_name2 | Secondary administrative division (e.g., county, district). | Administrative Name 2 |
| admin_code2 | Code for the secondary administrative division. | Administrative Code 2 |
| admin_name3 | Tertiary administrative division (e.g., municipality, borough). | Administrative Name 3 |
| admin_code3 | Code for the tertiary administrative division. | Administrative Code 3 |
| latitude | Latitude coordinate of the place. | Latitude |
| longitude | Longitude coordinate of the place. | Longitude |
| accuracy | Accuracy level of the latitude and longitude coordinates. | Accuracy |
| alternative_city_name | Alternative name(s) for the city or place. | Alternative City Name |
Download
Download sample CSVAbout
- Last updated
- 29 August 2026
- Total rows
- ...
- Format
- CSV
- File size
- 388 kB
About this dataset
Postal Codes Dataset for South Africa (ZA)
This dataset contains South African postal codes – 3,920 rows, 3,266 distinct codes, all 9 provinces and all 52 district/metro municipalities. Built from GeoNames' postal export, enriched with province and municipality data joined in from GeoNames' own general gazetteer.
Note: This dataset is a sample containing the first 100 rows. If you need access to the complete dataset, please contact our sales team for more information: datahub@datopian.com
Data Sources
Place names, postal codes and coordinates are sourced from GeoNames. Province and district/metro-municipality names are recovered by joining the postal data to GeoNames' own general gazetteer by place name and coordinate proximity (the postal export alone carries no admin fields) – see ATTRIBUTION.txt for the join method and its measured accuracy. Both are licensed CC BY 4.0.
Licensing status. Cleared to sell – licence_status.decision: compatible. See ATTRIBUTION.txt for the full attribution notice.
Coverage note. Admin assignment is a coordinate-based join against a gazetteer, not an official South African administrative register – high confidence (median distance ~1.2 km) but not authoritative in the way a government register would be. Disclosed, not presented as official.
Usage
The dataset files are available in CSV format and can be accessed and downloaded using the links provided in the datapackage.yml.
For access to the full dataset or other inquiries, please contact our sales team at datahub@datopian.com