Household income within poverty guidelines
Checks that annual household income is at or below a percentage of the HHS poverty guidelines for the household's size.
Finds the HHS poverty guideline for the household's size, multiplies it by the given percent, and passes when annual household income is equal to or less than the result. For 2026 the guideline is $15,960 for one person plus $5,680 for each additional person, so 150% is $23,940 for one person plus $8,520 for each additional person. Returns no result when income or household size is missing or invalid, or when the guideline year is not available.
- API endpoint
POST /api/v1/checks/income/household-income-within-poverty-guidelines- Last reviewed
- November 12, 2026
Parameters
| Name | Type | Description |
|---|---|---|
percent | number | Percentage of the poverty guideline to use as the income limit, for example 150 for 150%. |
guidelineYear | number | Year of the HHS poverty guidelines to use, for example 2026. |
Inputs
The screener answers this check reads:
| Field | Type |
|---|---|
situation.householdIncome | number |
situation.householdSize | number |
Examples
One person at 150 percentPasses
A one-person household with $23,940 a year is exactly at 150% of the 2026 poverty guideline, which matches PA LIHEAP's published limit, so the check passes.
Request
{
"parameters": {
"guidelineYear": 2026,
"percent": 150
},
"situation": {
"householdIncome": 23940,
"householdSize": 1
}
}One person over 150 percentFails
A one-person household with one cent more than $23,940 a year is over 150% of the 2026 guideline, so the check fails.
Request
{
"parameters": {
"guidelineYear": 2026,
"percent": 150
},
"situation": {
"householdIncome": 23940.01,
"householdSize": 1
}
}Limitations
- Only the 2026 guidelines are available. Any other guideline year returns no result.
- Uses the guidelines for the 48 contiguous states and DC, not those for Alaska or Hawaii.
- Takes household income and size as given. It does not decide whose income counts, which income is excluded, or how pay is annualized.
- Does not round the limit. A program that publishes rounded limits may differ by a few dollars.
Sources
- Pennsylvania LIHEAP FFY 2027 Final State Plan: Income eligibility: 150% of the 2026 federal poverty guidelines, by household size (checked November 12, 2026)
- Pennsylvania DHS: LIHEAP: Income limits by household size (checked November 12, 2026)
Implementation notes
For contributors maintaining the DMN model.
checkResult: The 2026 values were derived from PA LIHEAP's published 150% table ($23,940 for one person, plus $8,520 for each additional person). Add each new year to the guidelines list when HHS publishes it in January.