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 AIBolivia 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 -- Bolivia has no official 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
- 4 September 2026
- Total rows
- ...
- Format
- CSV
- File size
- 1.44 MB
About this dataset
Bolivia (BO) — internal licensing notes
Source research, 2026-09-03 — structural fit check, not a licensing question
Confirmed: Bolivia has no national postal code system. This is a structural non-fit for this product line, not a sourcing gap to keep chasing.
What was checked
- GeoNames: no export exists at all —
download.geonames.org/export/zip/BO.zipreturns a plain 404, not an empty/near-empty file. Bolivia is simply not in GeoNames' ~100-country supported list. The currently-livebo/bo.csvon R2 (159 bytes) is a header-only placeholder with zero data rows — consistent with there being nothing to fetch, not a broken fetch. - Web research, 2026-09-03: multiple independent sources agree Bolivia
does not operate a postal code system for domestic addressing. The
Agencia Boliviana de Correos (the national postal operator since 2018,
successor to Empresa de Correos de Bolivia) routes mail by street, zone,
city and department — not by a geolocated numeric code. Common practice
for online-shopping forms that require a postal code field is to enter a
placeholder like
0000or00591; this is a workaround for foreign checkout forms, not evidence of a real code system.
Why this isn't a "find a better source" problem
This product (postal-codes-{cc}) is, structurally, a list of postal
codes. A country with no postal-code system cannot be a SKU in it, no
matter how thorough the source search — same conclusion already reached
for Togo in the FedEx-schema product line
(fedex-agents-prototype/countries/TG/ planning notes). There is no
admin-division-only fallback here the way there is for the FedEx 12-column
schema's postalCode: "00000" convention — the postal-codes 13-column
schema has no equivalent "no code" row type; CLAUDE.md states this
explicitly ("not applicable — the product is a list of postal codes; a
00000 row does not belong in it").
Verdict (superseded below)
Permanent close-out as a PAID postal-codes product. Do not re-open that question without a genuine change in Bolivia's postal infrastructure (there is no indication one is planned).
Revised 2026-09-04 — issued free as a locality directory, not closed entirely
Human decision: rather than ship nothing, issue what CAN be known
(department + locality + coordinates) as a free dataset, with
postal_code intentionally and permanently empty on every row. This does
not reopen the "no postal codes" verdict above — Bolivia still has none,
and this is not sold as if it did.
Source: GeoNames' MAIN gazetteer dump
(download.geonames.org/export/dump/BO.zip) — a different GeoNames
product from the postal-code export (which returns a 404 for Bolivia, as
documented above). Filtered to feature class P (populated places).
Licence CC BY 4.0, same as the postal export elsewhere in this catalogue.
admin_code1 derived to ISO 3166-2:BO via a verified name crosswalk (9 departments, the single-letter vehicle-registration-plate codes, confirmed against Wikipedia's ISO_3166-2:BO page 2026-09-04).
Build — 2026-09-04
Built via datasets/bo/scripts/build_postal_codes_product.py.
| value | |
|---|---|
| Final rows | 25,804 |
| Departments covered | 9/9 |
| Rows with unresolved admin1 (source code "00"/blank) | 52 |
Frictionless validation: valid: True. is_premium: false —
datasets/bo/datapackage.yml updated accordingly, data_available: true.
Status: built and validated locally only. Nothing published to R2, nothing committed to git yet.