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 AIEthiopia 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 -- Ethiopia has no deployed national postal code system (trial-only, Addis Ababa only). | 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
- 4 September 2026
- Total rows
- ...
- Format
- CSV
- File size
- 546 kB
About this dataset
Ethiopia (ET) — internal licensing notes
Source research, 2026-09-03 — structural fit check, not a licensing question
Confirmed: Ethiopia has no deployed national postal code system, and what exists is not buildable as a product. Different shape from Bolivia/ Curaçao/Côte d'Ivoire (a real, if minimal, system exists) but the same practical outcome: no source exists to build from.
What was checked
- GeoNames: no export exists —
download.geonames.org/export/zip/ET.zipreturns a plain 404. The currently-liveet/et.csvon R2 (159 bytes) is a header-only placeholder. - Wikipedia's "List of postal codes", checked directly 2026-09-03: Ethiopia's entry states the 4-digit code format "is only used on a trial basis for Addis Ababa addresses" — not a national system.
- Web research confirms this is essentially a single code, not a real
granular system: multiple sources describe Addis Ababa's own postal
code as simply
1000(a whole-city placeholder), with no evidence of a real per-district or per-address breakdown in official use. The Ethiopian Postal Service (Ethiopost/ethiopostal.com) has no published bulk list. Third-party sites (Scribd, 56ok.com, postcodebase.com) offer "guides" of unclear/unverifiable provenance, the same low-authority shape this project already treats skeptically elsewhere (e.g. Uganda's aggregator figures).
Why this isn't a "find a better source" problem
Even if a trial system technically exists, there is no complete, open,
bulk-fetchable source describing it — the same practical block as Uganda
(a real-but-undeployed-at-scale system with no bulk source to build a
national product from), not the "no system at all" shape of Bolivia/
Curaçao/Côte d'Ivoire. Either way, there is nothing to build a
postal-codes-et product from today.
Verdict (superseded below)
No build as a PAID postal-codes product, revisitable if Ethiopost or the government ever publishes a real national rollout with a bulk list — same class of open question as Uganda.
Revised 2026-09-04 — issued free as a locality directory, not closed entirely
Human decision: issue what CAN be known (region + locality + coordinates)
as a free dataset, postal_code permanently empty.
Source: GeoNames' MAIN gazetteer dump
(download.geonames.org/export/dump/ET.zip), filtered to feature class
P (populated places). Licence CC BY 4.0.
admin_code1 derived to ISO 3166-2:ET via a verified name crosswalk,
confirmed against Wikipedia's ISO_3166-2:ET page 2026-09-04. Genuine
currency finding: GeoNames' own admin1 reference table lists 14
regions, including "Central Ethiopia Regional State" and "South Ethiopia
Regional State" — both created in Ethiopia's 2023 reform that split the
former Southern Nations, Nationalities, and Peoples' Region. ISO has not
yet assigned codes for either. Rather than force these into the now-stale
"SNNPR" ISO code or invent one, their rows (580 of 11,113) ship with
admin_code1 blank — disclosed, not hidden.
Build — 2026-09-04
Built via datasets/et/scripts/build_postal_codes_product.py.
| value | |
|---|---|
| Final rows | 11,113 |
| Regions represented | 14 (12 with a current ISO code) |
| Rows with no ISO code yet (2023-reform regions) | 580 |
| Rows with unresolved admin1 (source code "00"/blank) | 162 |
Frictionless validation: valid: True. is_premium: false —
datasets/et/datapackage.yml updated accordingly, data_available: true.
Status: built and validated locally only. Nothing published to R2, nothing committed to git yet.