A TypeScript-ready NPM package providing up-to-date Philippine Standard Geographic Code (PSGC) data, including Regions, Provinces, Municipalities/Cities, and Barangays, based on the official releases of the Philippine Statistics Authority (PSA).
- 📦 Pre-packaged JSON data (no database setup required).
- 🔍 Strongly typed with TypeScript.
- 🗂️ Easy utilities to query regions, provinces, municipalities/cities, and barangays.
- 🔄 Updated quarterly in sync with PSA’s official releases.
- 🚀 Ready for both Node.js (backend) and modern frontend frameworks.
The PSA defines PSGC codes using a 10-digit format:
RR PPP MM BBB
- RR → Region code
- PPP → Provincial code / Highly Urbanized City (HUC) / Independent Component City (ICC) / Component City (CC)
- MM → Municipality/City code
- BBB → Barangay code
Derived identifiers:
- PPPMM → Municipality/City identifier
- PPPMMBBB → Barangay identifier
📌 Example:
- 0434040000 → Calamba City
- 0434040057 → Barangay Milagrosa (Tulo), Calamba City
npm install @jobuntux/psgc
# or
yarn add @jobuntux/psgc
# or
pnpm add @jobuntux/psgcThe dataset includes:
- 18 Regions
- 83 Provinces (including NCR as pseudo-province)
- 1,656 Municipalities & Cities (149 Cities, 1,493 Municipalities, 14 Sub-Municipalities)
- 42,011 Barangays
| Field | Details |
|---|---|
| Title | Philippine Standard Geographic Code (PSGC) |
| Originator | Philippine Statistics Authority (PSA) |
| Publication Date | 30 June 2025 |
| Abstract | The PSGC is a systematic classification and coding of geographic areas in the country based on the four hierarchical levels: region, province, city/municipality, and barangay. |
| Process | Updated based on official changes in the administrative structure of the country through Republic Acts and local ordinances ratified via plebiscites conducted by the COMELEC. |
| Progress | Ongoing (updated quarterly) |
| Access Constraints | None |
| Use Constraints | Acknowledgement of the Philippine Statistics Authority (PSA) as the source |
| Disclaimer | - Distributed without warranty of any kind, expressed or implied. - Responsibility for interpretation and use lies with the user. - PSA is not liable for damages arising from its use. |
| Primary Contact | Statistical Classifications Division (SCD), Standards Service |
| Contact Persons | Emerson M. Aquino / Von Jeric F. Adona / Emmanuel V. Prades |
| Organization | Philippine Statistics Authority (PSA) |
| Telephone | (+632) 8376-1867 |
| Fax | None |
| scd.staff@psa.gov.ph |
Refer to https://jobuntux.github.io/psgc/
We welcome contributions! 🎉
Check out the Contributing Guide to get started.
MIT © jobuntux