Philippine poverty incidence
get_poverty_statsRetrieve poverty incidence statistics for the Philippines, optionally filtered by region, from the latest PSA data.
Instructions
Poverty incidence from the PSA Full Year Poverty Statistics table.
PSA publishes this once a year, with a lag. As of 2026-09 the latest published year is 2023. The tool discovers the current table live, so a later release shows up without a code change. It also returns the subsistence incidence when PSA publishes both tables for the same year. Examples:
get_poverty_stats() national poverty incidence, latest year get_poverty_stats(region="Bicol") one region, PSA label get_poverty_stats(region="NCR") National Capital Region
On failure: a discovery failure, a missing Incidence dimension, an unparseable year label, or a query failure sets data_status "unavailable" and upstream_error true. A region PSA does not list sets data_status "invalid_request" and validation_error true. A table with no matching incidence measure, or a cell whose values field is not a list, sets data_status "indeterminate" and upstream_error true. A published ".." cell for the region and year sets no error flag and no data_status. Check caveats instead. A subsistence-table failure sets upstream_error true on an otherwise valid poverty figure, but leaves data_status at "success".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | PH region (None returns national). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||