PSGC Terminology FHIR Implementation Guide
0.1.0 - ci-build Philippines flag

PSGC Terminology FHIR Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

CodeSystem Declaration

A conformant server SHALL expose a CodeSystem resource declaring PSGC metadata.

Key Characteristics

{
  "resourceType": "CodeSystem",
  "url": "https://psa.gov.ph/classification/psgc",
  "hierarchyMeaning": "part-of",
  "versionNeeded": true,
  "content": "not-present",
  "count": 43768
}

Hierarchy

0100000000areaName = "Region I"level = Regdigits 1-20102800000areaName = "Ilocos Norte"level = Provdigits 3-50102801000areaName = "Adams"level = Mundigits 6-70102801001areaName = "Adams (Pob.)"level = Bgydigits 8-10part-ofpart-ofpart-of


The 10-digit PSGC code encodes hierarchy positionally. This means $subsumes can be implemented as simple prefix comparison — no graph traversal required.

FHIRPath for $subsumes

// A subsumes B when B starts with A's non-zero prefix
%codeB.startsWith(%codeA.replaceMatches('0+$', ''))

Properties

Property Type Description
level code Geographic tier (Reg, Prov, City, Mun, SubMun, Bgy)
parent code Direct parent PSGC code
incomeClassification string DOF income class (1st–6th)
urbanRural code U (Urban) or R (Rural)
inactive boolean True if abolished in a later release

Designations

Use Description
old Former/previous area name (from PSA "Old names" column)

Version Scheme

Versions follow the pattern Q{quarter}_{year} (e.g. Q1_2026, Q4_2024).

FHIRPath version format invariant

matches('^Q[1-4]_20[0-9]{2}$')

PSA publishes quarterly. A conformant server SHOULD support at least the two most recent quarterly releases.