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 International 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 Panama, PA
| 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
- 11 September 2026
- Total rows
- ...
- Format
- CSV
- File size
- 7.35 kB
About this dataset
Panama (PA) — internal licensing notes
Source research, 2026-09-11 — tier-1 check done, real official source found but unreachable
Panama has a genuinely well-structured, modern postal system — a geolocated 7-digit code where the first 2 digits are the ISO 3166-2:PA province/comarca code, resolving down to corregimiento (township) and city-block level. This is a real, deliberately-designed official system, not a legacy/ad hoc one.
The official source — found, confirmed to exist, could not be reached
A dedicated official government site exists at
codigospostalespanama.gob.pa ("Sistema de Códigos Postales de
Panamá") — found via search, distinct from (and more specific than) the
general correospanama.gob.pa postal-operator site. Multiple direct
fetch attempts (WebFetch and curl, with a browser user-agent, longer
timeouts) all failed: connection timeout or "connection reset by peer" —
consistent with a network-level block from this environment (same class
of issue as Japan Post's domain and Omniva's JS modal earlier in this
project), not evidence the site itself lacks bulk data.
Not attempted further in this pass per the tunnel-vision rule (several
distinct fetch attempts already made). Worth a real retry from an
environment that can reach .gob.pa domains.
Adjacent official geodata, not the postal codes themselves
Panama's national open-data ecosystem is real and active: GeoPortal MIVIOT (territorial planning, CSV/KML/GeoJSON/Shapefile downloads, Panama's 2017 national open-data policy) and IPDE (spatial data infrastructure, WFS/WMS) both exist and are reachable in principle, but neither was confirmed to carry the postal-code layer itself — they cover administrative/planning boundaries, a different (if related) dataset.
GeoNames — fallback, not evaluated in depth this pass
download.geonames.org/export/zip/PA.zip returns 200 — GeoNames has
PA coverage. Per this project's standing rule, this is the fallback of
last resort, not yet compared against the (unreachable) official system
in this pass.
Verdict
Built 2026-09-11 — re-tested codigospostalespanama.gob.pa first
(now reachable, HTTP 200, unlike the earlier attempts in this file) but
its static shell is an empty Vite SPA (<div id="root">) and its client
JS bundle exposes no bulk-download/export/CSV endpoint on direct
inspection — consistent with a citizen address-lookup tool, not a
data-distribution portal. Fell back to GeoNames as anticipated: 729 rows,
10/14 ISO 3166-2:PA subdivisions covered via a verified name-based
crosswalk. 30 rows (2 GeoNames admin1 buckets) intentionally left with a
blank admin_code1 rather than a guessed one — "Darien Y Comarca Embera"
conflates two real, separate ISO subdivisions (Darien PA-5 + Embera-
Wounaan Comarca PA-EM) with no per-row way to split them, and "Comarca
Wargandi" is a real comarca but legally a corregimiento of Darien, absent
from the 14-unit ISO list itself. GeoNames' "Panama" bucket also predates
the 2014 Panama Oeste (PA-10) split and lumps both together — disclosed,
not resolved. See scripts/build_postal_codes_product.py.
Published: git (datasets/pa/{datapackage.yml,scripts/}) and the
samples bucket (100-row preview, postal-codes-samples key pa/pa.csv).
Main R2 bucket publish blocked — same session-wide 403/AccessDenied
as every other main-bucket write this session; not re-tested for PA
specifically since LK's identical publish_r2.py --apply already failed
with AccessDenied on PutObject moments earlier. _meta/catalog.json
not updated. datapackage.yml set to is_premium: true, premium_tier: B
(single-source GeoNames normalisation, same shape as PK/KE/EE/LK), real
licenses/sources (was a placeholder "Multiple sources" link).