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 AICuraçao 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 -- Curaçao has no 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). Always empty -- Curaçao has no ISO 3166-2 subdivisions. | 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
- 4.24 kB
About this dataset
Curaçao (CW) — internal licensing notes
Source research, 2026-09-03 — structural fit check, not a licensing question
Confirmed: Curaçao has no postal code system. Structural non-fit for
this product line, same conclusion as Bolivia (see datasets/bo/.licensing-notes.md).
What was checked
- GeoNames: no export exists —
download.geonames.org/export/zip/CW.zipreturns a plain 404. Curaçao is not in GeoNames' supported postal-code country list. The currently-livecw/cw.csvon R2 (159 bytes) is a header-only placeholder, consistent with nothing to fetch. - Web research, 2026-09-03: multiple independent sources agree Curaçao does not use postal/ZIP codes. Mail is addressed by locality, street or PO Box, and country name only — no numeric or alphanumeric code is assigned to addresses. (Note: one search result named "Post Aruba N.V." as the operator handling this — that looks like a cross-contaminated result confusing Curaçao with the similarly-situated Dutch Caribbean territory of Aruba; the actual Curaçao postal operator was not independently re-verified in this pass and should not be taken from that source. The "no postal code system" conclusion itself is corroborated across multiple sources and is not dependent on which operator's name is correct.)
- Curaçao is an autonomous country within the Kingdom of the Netherlands, distinct from both the four-digit-plus-letters European Netherlands system and the Caribbean Netherlands special municipalities (Bonaire, Sint Eustatius, Saba), which per Wikipedia "do not as yet have postal codes" but have a system planned by end of 2026 — that plan applies to the special municipalities, not to Curaçao, which is constitutionally separate from the Netherlands proper.
Why this isn't a "find a better source" problem
Same reasoning as Bolivia: this product is structurally a list of postal
codes, and the postal-codes 13-column schema has no "no code" row
convention (unlike the FedEx 12-column schema's postalCode: "00000"
fallback). A country with no system cannot be represented in this SKU.
Verdict (superseded below)
Permanent close-out as a PAID postal-codes product. Do not re-open that question without a genuine change in Curaçao's postal infrastructure.
Revised 2026-09-04 — issued free as a locality directory, not closed entirely
Human decision: issue what CAN be known (locality + coordinates) as a
free dataset, postal_code permanently empty. Curaçao also has NO
ISO 3166-2 subdivisions at all (Wikipedia's ISO_3166-2:CW page, verified
2026-09-04: "no ISO 3166-2 codes are defined… the territory has no
defined subdivisions") — admin_name1/admin_code1 correctly left empty
for every row, not an omission.
Source: GeoNames' MAIN gazetteer dump
(download.geonames.org/export/dump/CW.zip), filtered to feature class
P (populated places). Licence CC BY 4.0.
Build — 2026-09-04
Built via datasets/cw/scripts/build_postal_codes_product.py.
| value | |
|---|---|
| Final rows | 100 |
Frictionless validation: valid: True. is_premium: false —
datasets/cw/datapackage.yml updated accordingly, data_available: true.
Status: built and validated locally only. Nothing published to R2, nothing committed to git yet.