Part of a Data Solution

Postal Codes Solution
Every worldwide postal-code dataset in one bundle — the ultimate global reference for precise postal codes.
Explore →

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 license

20% off

$49.90$39.92

one-time payment

Download sample · CSV · 9.41 kB Report an Issue

API Access

Access dataset files directly from scripts, code, or AI agents.

Browse dataset files

Dataset Files

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.

/logistics/postal-codes-ee/

├ .licensing-notes.md

https://datahub.io/logistics/postal-codes-ee/_r/-/.licensing-notes.md

├ .migration-notes.md

https://datahub.io/logistics/postal-codes-ee/_r/-/.migration-notes.md

├ ATTRIBUTION.txt

https://datahub.io/logistics/postal-codes-ee/_r/-/ATTRIBUTION.txt

├ README.md

https://datahub.io/logistics/postal-codes-ee/_r/-/README.md

└ datapackage.yaml

https://datahub.io/logistics/postal-codes-ee/_r/-/datapackage.yaml

Key Files

Start with these files — they give you everything you need to understand and access the dataset.

datapackage.yaml— metadata & schema

https://datahub.io/logistics/postal-codes-ee/_r/-/datapackage.yaml

README.md— documentation

https://datahub.io/logistics/postal-codes-ee/_r/-/README.md

Typical Usage

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-ee-sample

Field	Type	Description	Constraints	Title
country_code	string	ISO 3166-1 alpha-2 -- always EE		Country Code
postal_code	string	Estonian postal code (5 digits)	{ "pattern": "^\\d{5}$" }	Postal Code
place_name	string	Locality/place name		Place Name
admin_name1	string	Maakond (county) -- 15/15 covered		Administrative Name 1
admin_code1	string	ISO 3166-2:EE code		Administrative Code 1
admin_name2	string	Vald (parish/municipality) -- 71 distinct values		Administrative Name 2
admin_code2	string	GeoNames' own internal code -- not an official ISO code		Administrative Code 2
admin_name3	string	Linn/asundus (town/settlement)		Administrative Name 3
admin_code3	string	GeoNames' own internal code		Administrative Code 3
latitude	number	GeoNames latitude (WGS84)		Latitude
longitude	number	GeoNames longitude (WGS84)		Longitude
accuracy	string	GeoNames accuracy of latitude/longitude. GeoNames documents 1=estimated, 4=geonameid, 6=centroid of addresses or shape; other values (e.g. 3) occur upstream without documentation. Empty where GeoNames gives none.		Accuracy
alternative_city_name	string	Not populated in this release		Alternative City Name

Download

Download sample CSV

About

Last updated: 6 October 2026
Total rows: 100
Format: CSV
File size: 9.41 kB
Source: GeoNames postal code database -- Estonia (EE)
License: Creative Commons Attribution 4.0 International

About this dataset

Estonia (EE) — internal licensing notes

Source research, 2026-09-03 — tier-1 check done, real source found but unreachable

Checked Omniva (Estonia's national postal operator) first: a real official ZIP-code download page exists at omniva.ee/en/zip-codes/zip-codes-download/ (confirmed via search: "ZIP codes are available for download in .csv and .xml formats from Omniva"). Fetched the page directly and traced through to the Estonian-language version (omniva.ee/postiindeks/sihtnumbrid-allalaadimiseks/) — the actual file link is rendered behind a JS-driven modal popup (?mode=popup, opened via an onclick handler), not a static <a href>. Static curl/WebFetch cannot reach the real download URL from this build environment. This is a genuine, disclosed tooling limitation — the source is real and better in principle, not ruled out on data-quality or licensing grounds. Worth a follow-up attempt from an environment that can execute the page's JS (a real browser or headless-browser fetch).

The source used instead — GeoNames EE

https://download.geonames.org/export/zip/EE.zip      # 5,398 rows

Licence CC-BY-4.0, verified against export/zip/readme.txt on 2026-09-03 — Estonia carries no per-country caveat.

Verified directly against the raw source file:

admin_name1/admin_code1 — Maakond (county), 15/15 covered. GeoNames' own numbering (01-21, with gaps) is unrelated to ISO 3166-2:EE's real codes (37-87) — verified against Wikipedia's ISO_3166-2:EE page 2026-09-03, name-based crosswalk required (same hazard class as JP/CZ/IN/PK in this batch).
admin_name2 — Vald (parish/municipality), 71 distinct values.
admin_name3 — populated on 100% of rows (5,398/5,398) — the most complete 3-tier GeoNames-only rebuild in this session's batch.
0 exact duplicate rows, 0 (postal_code, place_name) collisions, 0 literal "nan" strings.

licence_status

{
  "channel": "postal-codes-r2",
  "source_url": "https://download.geonames.org/export/zip/EE.zip",
  "licence_id": "CC-BY-4.0",
  "collected_at": "2026-09-03",
  "decision": "compatible",
  "decided_by": "claude-session-2026-09-03",
  "decided_at": "2026-09-03"
}

Proposed tier

B ($49). Clean, genuinely complete 3-tier single-source rebuild – the completeness alone would justify tier B even without the ISO crosswalk work.

Build — 2026-09-03

Built via datasets/ee/scripts/build_postal_codes_product.py.

	value
Final rows	5,398
Counties covered	15/15
Parishes/municipalities	71
admin_name3 (town/settlement) filled	5,398/5,398 (100%)
Distinct postal codes	5,293
(postal_code, place_name) collisions	0

Frictionless validation: valid: True.

Status: built and validated locally only. Nothing published to R2, nothing committed to git yet.