Skip to content

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

NameTypeDescription
percentnumberPercentage of the poverty guideline to use as the income limit, for example 150 for 150%.
guidelineYearnumberYear of the HHS poverty guidelines to use, for example 2026.

Inputs

The screener answers this check reads:

FieldType
situation.householdIncomenumber
situation.householdSizenumber

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

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.