Philippine Location Lookup API
Look up Philippine regions, provinces, cities, municipalities, and barangays using official PSGC (Philippine Standard Geographic Code) data. Features include cascading dropdown support, fuzzy search, ZIP code lookup, reverse ZIP, batch PSGC resolution, address hierarchy validation, island group filtering, and aggregate statistics. Ideal for building address forms, logistics systems, HR…
Philippine Location Lookup API endpoints
| Method | Endpoint | Description |
|---|---|---|
| lookup | ||
| GET |
lookup_barangay_v1_lookup_barangay_get /v1/lookup/barangay |
|
| GET |
lookup_psgc_v1_lookup_psgc__id__get /v1/lookup/psgc/{id} |
Resolve any PSGC ID (region, province, city, municipality, barangay) and return its full hierarchy chain. |
| GET |
cascade_v1_lookup_cascade_get /v1/lookup/cascade |
Given a parent ID, returns only the next level of the hierarchy. Optimized for address forms. If multiple parameters are provided, only the most specific is used (city > province… |
| GET |
validate_hierarchy_v1_lookup_validate_get /v1/lookup/validate |
Verify that a set of PSGC IDs (barangay, city, province, region) form a valid hierarchy chain. |
| GET |
lookup_zip_by_psgc_v1_lookup_zip__psgc_id__get /v1/lookup/zip/{psgc_id} |
Returns the ZIP code associated with a barangay's PSGC ID (9-digit format from zip index). |
| GET |
lookup_zip_v1_lookup_zip_get /v1/lookup/zip |
Returns all barangays that share the given ZIP code, with full location hierarchy. |
| search | ||
| GET |
search_locations_v1_search_get /v1/search |
|
| regions | ||
| GET |
list_regions_v1_regions_get /v1/regions |
|
| GET |
get_region_v1_regions__id__get /v1/regions/{id} |
|
| provinces | ||
| GET |
list_provinces_v1_provinces_get /v1/provinces |
|
| GET |
get_province_v1_provinces__id__get /v1/provinces/{id} |
|
| cities-municipalities | ||
| GET |
list_cities_municipalities_v1_cities_municipalities_get /v1/cities-municipalities |
|
| GET |
get_city_municipality_v1_cities_municipalities__id__get /v1/cities-municipalities/{id} |
|
| barangays | ||
| GET |
list_barangays_v1_barangays_get /v1/barangays |
|
| GET |
get_barangay_v1_barangays__id__get /v1/barangays/{id} |
|
| statistics | ||
| GET |
get_stats_v1_stats_get /v1/stats |
Returns total counts of all geographic levels (regions, provinces, cities, municipalities, barangays). |
| GET |
get_stats_detail_v1_stats__level___id__get /v1/stats/{level}/{id} |
Returns counts of child locations under a specific region, province, or city/municipality. |
| island-groups | ||
| GET |
list_island_groups_v1_island_groups_get /v1/island-groups |
Returns Luzon, Visayas, and Mindanao with region counts. |
| GET |
get_island_group_regions_v1_island_groups__group__regions_get /v1/island-groups/{group}/regions |
Returns all regions belonging to the specified island group (luzon, visayas, mindanao). |
| batch | ||
| POST |
batch_lookup_v1_batch_lookup_post /v1/batch/lookup |
Resolve up to 50 PSGC IDs in a single request. Each result indicates whether the ID was found. |
Philippine Location Lookup API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 5 / second |
|
| PRO | $4.99 / month | 20 / second |
|
| ULTRA Recommended | $9.99 / month | 50 / second |
|
| MEGA | $19.99 / month | 100 / second |
|