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.
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
Explore with AIZimbabwe Locality Directory (No Postal Code System)
| Field | Description | Title |
|---|---|---|
| country_code | ISO 3166-1 alpha-2 code for the country. | Country Code |
| postal_code | Postal code for the location. Always empty -- Zimbabwe has no operational postal code system. | 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 CSVAbout
- Last updated
- 15 September 2026
- Total rows
- ...
- Format
- CSV
- File size
- 122 kB
About this dataset
Zimbabwe (ZW) — internal licensing notes
Source research, 2026-09-11 — structural fit check, not a licensing question
Confirmed: Zimbabwe has no postal code system. Zimpost (the national
postal operator, since 1892) delivers mail using descriptive addresses —
locality, street or PO Box, country — rather than postcodes. Confirmed
independently via web research 2026-09-11, consistent with the existing
FedEx-schema registry entry for ZWE in fedex-agents-prototype/CLAUDE.md
("no postal code system").
What was checked
- GeoNames: no export exists —
download.geonames.org/export/zip/ZW.zipreturns a plain 404, consistent with there being nothing to fetch. - Existing FedEx-schema build:
fedex-agents-prototype/countries/ZWE/already has a real admin-only build (data/Zimbabwe.csv,data/admin.csv,research.json,qa_log.json) — Province → District, with the finding that "1,970 wards exist but no open tabular dataset" exists for a real admin3 tier within a 5-year recency window. That build could be reused/ converted as the admin source for a free locality directory here, same approach as Bolivia/Côte d'Ivoire/Ethiopia/Uganda's admin-only builds earlier in this project — not attempted in this pass (research only).
Verdict
Permanent close-out as a postal-codes product — same class as
Bolivia/Curaçao/Côte d'Ivoire. No licence_status applies to the
postal-code question (there is no data to gate). data_available
unchanged (false). If a free admin-only locality directory is wanted
(matching BO/CW/CI/ET/UG), the existing FedEx ZWE build or GeoNames' main
gazetteer dump are both real starting points for a future build pass.
Build — 2026-09-15
Re-checked for a real postal-code system before building: no evidence
found (web search 2026-09-15) of any operational Zimpost/government
postcode rollout; aggregator sites (geopostcodes.com, postcodebase.com)
surface non-official placeholder codes, not a real system — same pattern
seen elsewhere in this catalogue. download.geonames.org/export/zip/ZW.zip
still 404s. Proceeded with the free locality-only build, same class as
BO/CW/CI/ET/UG/LY.
Built datasets/zw/scripts/build_postal_codes_product.py from GeoNames'
main gazetteer dump (download.geonames.org/export/dump/ZW.zip, CC BY
4.0), filtered to feature class P (populated places).
- 2,101 rows,
postal_codeempty on every row (structural fact, not a gap). - admin_code1 (ISO 3166-2:ZW): 10/10 provinces covered. Verified the
ISO list directly against Wikipedia's ISO_3166-2:ZW page (2026-09-15):
BU, HA, MA, MC, ME, MW, MV, MN, MS, MI. GeoNames' own 10 ZW admin1
buckets (ZW.01–ZW.10) map cleanly one-to-one onto all 10 ISO codes by
name — no unmapped bucket. Independently cross-checked against
fedex-agents-prototype/countries/ZWE/research.json, which reports the same 10 provinces and the same ISO codes from its own Wikipedia research pass. - 2 of 2,101 rows carry GeoNames' reserved admin1 code
00("general features where no specific adm1 code is defined") — left with blankadmin_name1/admin_code1rather than guessed. admin_name2/admin_code2/admin_name3/admin_code3/accuracy/alternative_city_namenot populated in this release (GeoNames' main dump doesn't carry a district/ward tier or a postal-accuracy scale).licence_status.decision:compatible(CC BY 4.0, GeoNames), channelpostal-codes-r2.
Published to both R2 buckets (main postal-codes full package + zip;
postal-codes-samples full csv, since this is a free dataset with no
paid tier to hold back) and updated the main bucket's
_meta/catalog.json ZW entry (bytes/rows/updated) — entry count
confirmed unchanged at 248 before and after. datasets/zw/datapackage.yml
updated to is_premium: false, data_available: true, with real
GeoNames CC BY 4.0 sources/licenses.