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 (GeoNames) 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.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-ph-sample
| Field | Type | Description | Constraints | Title |
|---|---|---|---|---|
| country_code | string | ISO 3166-1 alpha-2 country code — always PH | { "pattern": "^PH$", "required": true } | Country Code |
| postal_code | string | 4-digit Philippine ZIP code | { "pattern": "^\\d{4}$", "required": true } | Postal Code |
| place_name | string | City, municipality, barangay or post-office station name as supplied by the source | { "required": true } | Place Name |
| admin_name1 | string | Region (Rehiyon) — blank on institutional codes | Administrative Name 1 | |
| admin_code1 | string | ISO 3166-2:PH region code, PH- prefix stripped. There is no 04. Blank on institutional codes | { "pattern": "^(0[0-35-9]|1[0-5]|4[01])$" } | Administrative Code 1 |
| admin_name2 | string | Province; for the National Capital Region, the PSA district — blank on institutional codes | Administrative Name 2 | |
| admin_code2 | string | PSA PSGC 9-digit code for the province or NCR district | Administrative Code 2 | |
| admin_name3 | string | City or Municipality (LGU) that place_name belongs to, resolved against the PSA PSGC register | Administrative Name 3 | |
| admin_code3 | string | PSA PSGC 9-digit code for the city or municipality | Administrative Code 3 | |
| latitude | number | Latitude, decimal degrees (WGS84) | Latitude | |
| longitude | number | Longitude, decimal degrees (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 | Local-language or historic name where the source supplied one genuinely different from place_name | Alternative City Name |
Download
Download sample CSVAbout
- Last updated
- 3 October 2026
- Total rows
- 100
- Format
- CSV
- File size
- 10.4 kB
About this dataset
Postal Codes Dataset for Philippines (PH)
This dataset lists Philippine ZIP codes with place names, regions, provinces (or National Capital Region districts), cities and municipalities, and WGS84 coordinates, across every administrative region.
Column definitions, row count, size and last-updated date are in datapackage.yaml.
Data Sources
- Postal codes, place names and coordinates: © GeoNames, postal code export for the Philippines, CC BY 4.0.
- Alternative city names: the GeoNames gazetteer for the Philippines, same licence.
- Province and city/municipality assignment: Philippine Standard Geographic Code (PSGC) of the Philippine Statistics Authority, read through psgc.gitlab.io.
Changes made to the source data: place and administrative names cleaned (parenthesised parts dropped,
punctuation replaced by spaces); admin_code1 set to the ISO 3166-2:PH region code with the PH- prefix
stripped (Metro Manila NCR becomes 00); admin_code2, admin_name3 and admin_code3 added from the
PSGC; alternative_city_name added from the gazetteer.
Not endorsed by, or affiliated with, GeoNames or the Philippine Statistics Authority.
Known limitations
- ZIP is not one-to-one with place. Metro Manila codes in particular are shared across several named
barangays and post-office stations, so one code can appear on many rows. The primary key is
(
postal_code,place_name), neverpostal_codealone. - Institutional codes: the Philippines assigns ZIP codes to large institutional mailers and PO Box holders
as well as to places. On those rows
place_nameis an organisation and the source supplies no administrative assignment, so those cells are blank rather than guessed. Filter on a populatedadmin_name1if you need geographic rows only. - Coordinate accuracy: rows with
accuracy1 have a point interpolated by the source from neighbouring postal codes rather than matched to a gazetteer entry, and it can fall outside the province the row names. Checkaccuracybefore relying on a coordinate. - Region codes: there is no region
04(the old Region IV was split into40CALABARZON and41MIMAROPA), and14is BARMM while15is the Cordillera Administrative Region.
Usage
The dataset files are available in CSV format and can be accessed and downloaded using
the links provided in datapackage.yaml. Read admin_code1 as text, never as a number: the National
Capital Region is 00.
For other inquiries, contact datahub@datopian.com