hua7450 · Oct 28, 2026 · Oct 3, 2026 · Oct 3, 2026 · Oct 21, 2026 · Oct 21, 2026
diff --git a/changelog.d/nd-liheap-wave2b.added.md b/changelog.d/nd-liheap-wave2b.added.md
@@ -0,0 +1 @@
+Add North Dakota LIHEAP (nd_liheap): FY2026 regular heating benefit paying 45% to 100% of the annual heating bill by state median income band, with heat-in-rent payments.
diff --git a/policyengine_us/parameters/gov/hhs/liheap/fpg_limit.yaml b/policyengine_us/parameters/gov/hhs/liheap/fpg_limit.yaml
@@ -0,0 +1,12 @@
+description: The US Department of Health and Human Services limits income eligibility to this percentage of the poverty guideline under the Low Income Home Energy Assistance Program.
+# Section 2605(b)(2)(B) of Pub. L. 97-35 set this ceiling, or 60 percent of the
+# state median income if greater, from fiscal year 1982.
+values:
+  1981-10-01: 1.5
+metadata:
+  period: year
+  unit: /1
+  label: LIHEAP poverty guideline income limit
+  reference:
+    - title: 42 U.S.C. 8624(b)(2)(B)(i)
+      href: https://www.law.cornell.edu/uscode/text/42/8624#b_2_B
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/fpg_year_lag.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/fpg_year_lag.yaml
@@ -0,0 +1,13 @@
+description: North Dakota uses the poverty guidelines from this many years before the model year for the federal income floor under the Low Income Home Energy Assistance Program.
+# Annual FY2026 uses the guidelines mandatory at its October 2025 season start.
+# Optional adoption of revised guidelines within the season is not modeled.
+# Backfilled and future seasons remain unverified estimates.
+values:
+  2025-10-01: 1
+metadata:
+  unit: year
+  period: year
+  label: North Dakota LIHEAP poverty guideline year lag
+  reference:
+    - title: 45 CFR 96.85(a), Application of poverty income guidelines
+      href: https://www.law.cornell.edu/cfr/text/45/96.85#a
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/cash_contribution_threshold.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/cash_contribution_threshold.yaml
@@ -0,0 +1,10 @@
+description: North Dakota counts recurring cash contributions at or above this annual amount under the Low Income Home Energy Assistance Program.
+values:
+  2025-06-01: 360
+metadata:
+  unit: currency-USD
+  period: year
+  label: North Dakota LIHEAP cash contribution threshold
+  reference:
+    - title: Energy Assistance Policy Manual 415-25-05-20-20, Unearned Income
+      href: https://www.nd.gov/dhs/policymanuals/415/415_25_05_20_20.htm
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/child_earnings_age_limit.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/child_earnings_age_limit.yaml
@@ -0,0 +1,10 @@
+description: North Dakota excludes qualifying dependent students' earnings below this age under the Low Income Home Energy Assistance Program.
+values:
+  2019-10-01: 20
+metadata:
+  unit: year
+  period: year
+  label: North Dakota LIHEAP student earnings exclusion age limit
+  reference:
+    - title: Energy Assistance Policy Manual 415-25-05-50, Children's Earned Income
+      href: https://www.nd.gov/dhs/policymanuals/415/415_25_05_50.htm
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/earned_income_deduction.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/earned_income_deduction.yaml
@@ -0,0 +1,10 @@
+description: North Dakota deducts this share of earned income under the Low Income Home Energy Assistance Program.
+values:
+  2025-06-01: 0.27
+metadata:
+  unit: /1
+  period: year
+  label: North Dakota LIHEAP earned income deduction rate
+  reference:
+    - title: Energy Assistance Policy Manual 415-25-05-05, Deductions from Income
+      href: https://www.nd.gov/dhs/policymanuals/415/415_25_05_05.htm
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/earned_sources.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/earned_sources.yaml
@@ -0,0 +1,24 @@
+description: North Dakota counts these separate earned income sources under the Low Income Home Energy Assistance Program.
+values:
+  2025-06-01:
+    - employment_income
+    - self_employment_income
+    - sstb_self_employment_income
+    - farm_operations_income
+    - partnership_income
+    - military_basic_pay
+# Report active net business income once, rather than repeating it in wages
+# or self-employment. Gross partnership reporting lacks policy expense detail.
+# Military basic pay is an input separate from wages; the subsistence and
+# housing allowances that 415-25-05-20-05 also counts as military pay have no
+# input. Employer-paid disability is not added separately because employment
+# income can already contain it and the overlap is unobserved.
+metadata:
+  unit: list
+  period: year
+  label: North Dakota LIHEAP earned income sources
+  reference:
+    - title: Energy Assistance Policy Manual 415-25-05-20-05, Earned Income
+      href: https://www.nd.gov/dhs/policymanuals/415/415_25_05_20_05.htm
+    - title: Energy Assistance Policy Manual 415-25-05-27-15, Treatment of Self-Employment Income
+      href: https://www.nd.gov/dhs/policymanuals/415/415_25_05_27_15.htm
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/unearned_sources.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/income/unearned_sources.yaml
@@ -0,0 +1,40 @@
+description: North Dakota counts these unearned income sources under the Low Income Home Energy Assistance Program.
+values:
+  2025-06-01:
+    - social_security
+    - ssi
+    - total_unemployment_compensation
+    - workers_compensation
+    - pension_income
+    - military_retirement_income
+    - retirement_distributions
+    - general_assistance
+    - railroad_benefits
+    - veterans_benefits
+    - disability_benefits
+    - survivor_benefits
+    - strike_benefits
+    - child_support_received
+    - alimony_income
+    - rental_income
+    - farm_rent_income
+    - s_corp_income
+    - estate_income
+# Retirement/estate receipts are treated as recurring; nonrecurring, education
+# and other exempt subtypes lack input distinctions. Disability payer is not
+# observed, so the broad disability input is treated as unearned. Rental inputs
+# lack active-business status and are treated as unearned. Ordinary investment
+# interest/dividends are excluded. Royalties, tribal exemptions, recoupments and
+# military allotments lack separately usable inputs. TANF is added once per unit.
+# Recurring gambling winnings count under 415-25-05-20-20, but the model cannot
+# separate recurring from nonrecurring winnings, so gambling_winnings is not
+# counted.
+metadata:
+  unit: list
+  period: year
+  label: North Dakota LIHEAP unearned income sources
+  reference:
+    - title: Energy Assistance Policy Manual 415-25-05-20-20, Unearned Income
+      href: https://www.nd.gov/dhs/policymanuals/415/415_25_05_20_20.htm
+    - title: Energy Assistance Policy Manual 415-25-05-27-15, Treatment of Self-Employment Income
+      href: https://www.nd.gov/dhs/policymanuals/415/415_25_05_27_15.htm
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/income_limits.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/income_limits.yaml
@@ -0,0 +1,181 @@
+description: North Dakota sets these inclusive annual income upper limits by household size and benefit band under the Low Income Home Energy Assistance Program.
+1:
+  1: {2025-10-01: 13_518}
+  2: {2025-10-01: 20_274}
+  3: {2025-10-01: 27_030}
+  4: {2025-10-01: 33_786}
+  5: {2025-10-01: 40_530}
+2:
+  1: {2025-10-01: 17_670}
+  2: {2025-10-01: 26_514}
+  3: {2025-10-01: 35_346}
+  4: {2025-10-01: 44_178}
+  5: {2025-10-01: 53_010}
+3:
+  1: {2025-10-01: 21_834}
+  2: {2025-10-01: 32_742}
+  3: {2025-10-01: 43_662}
+  4: {2025-10-01: 54_570}
+  5: {2025-10-01: 65_478}
+4:
+  1: {2025-10-01: 25_986}
+  2: {2025-10-01: 38_982}
+  3: {2025-10-01: 51_966}
+  4: {2025-10-01: 64_962}
+  5: {2025-10-01: 77_958}
+5:
+  1: {2025-10-01: 30_150}
+  2: {2025-10-01: 45_210}
+  3: {2025-10-01: 60_282}
+  4: {2025-10-01: 75_354}
+  5: {2025-10-01: 90_426}
+# The six-person 60% limit uses the FY2026 workbook's $102,894, which equals
+# 12 times the $8,574.50 monthly limit in manual 415-25-05-10.
+6:
+  1: {2025-10-01: 34_302}
+  2: {2025-10-01: 51_450}
+  3: {2025-10-01: 68_598}
+  4: {2025-10-01: 85_746}
+  5: {2025-10-01: 102_894}
+7:
+  1: {2025-10-01: 35_082}
+  2: {2025-10-01: 52_626}
+  3: {2025-10-01: 70_158}
+  4: {2025-10-01: 87_702}
+  5: {2025-10-01: 105_234}
+8:
+  1: {2025-10-01: 35_862}
+  2: {2025-10-01: 53_790}
+  3: {2025-10-01: 71_718}
+  4: {2025-10-01: 89_646}
+  5: {2025-10-01: 107_574}
+9:
+  1: {2025-10-01: 36_642}
+  2: {2025-10-01: 54_966}
+  3: {2025-10-01: 73_278}
+  4: {2025-10-01: 91_602}
+  5: {2025-10-01: 109_914}
+10:
+  1: {2025-10-01: 37_422}
+  2: {2025-10-01: 56_130}
+  3: {2025-10-01: 74_838}
+  4: {2025-10-01: 93_546}
+  5: {2025-10-01: 112_242}
+11:
+  1: {2025-10-01: 38_202}
+  2: {2025-10-01: 57_294}
+  3: {2025-10-01: 76_398}
+  4: {2025-10-01: 95_490}
+  5: {2025-10-01: 114_582}
+12:
+  1: {2025-10-01: 38_982}
+  2: {2025-10-01: 58_470}
+  3: {2025-10-01: 77_958}
+  4: {2025-10-01: 97_446}
+  5: {2025-10-01: 116_922}
+13:
+  1: {2025-10-01: 39_762}
+  2: {2025-10-01: 59_634}
+  3: {2025-10-01: 79_518}
+  4: {2025-10-01: 99_390}
+  5: {2025-10-01: 119_262}
+14:
+  1: {2025-10-01: 40_542}
+  2: {2025-10-01: 60_798}
+  3: {2025-10-01: 81_066}
+  4: {2025-10-01: 101_334}
+  5: {2025-10-01: 121_602}
+15:
+  1: {2025-10-01: 41_322}
+  2: {2025-10-01: 61_974}
+  3: {2025-10-01: 82_626}
+  4: {2025-10-01: 103_290}
+  5: {2025-10-01: 123_942}
+16:
+  1: {2025-10-01: 42_102}
+  2: {2025-10-01: 63_138}
+  3: {2025-10-01: 84_186}
+  4: {2025-10-01: 105_234}
+  5: {2025-10-01: 126_282}
+17:
+  1: {2025-10-01: 42_882}
+  2: {2025-10-01: 64_314}
+  3: {2025-10-01: 85_746}
+  4: {2025-10-01: 107_190}
+  5: {2025-10-01: 128_622}
+18:
+  1: {2025-10-01: 43_662}
+  2: {2025-10-01: 65_478}
+  3: {2025-10-01: 87_306}
+  4: {2025-10-01: 109_134}
+  5: {2025-10-01: 130_962}
+19:
+  1: {2025-10-01: 44_430}
+  2: {2025-10-01: 66_654}
+  3: {2025-10-01: 88_866}
+  4: {2025-10-01: 111_078}
+  5: {2025-10-01: 133_290}
+20:
+  1: {2025-10-01: 45_210}
+  2: {2025-10-01: 67_818}
+  3: {2025-10-01: 90_426}
+  4: {2025-10-01: 113_034}
+  5: {2025-10-01: 135_630}
+21:
+  1: {2025-10-01: 45_990}
+  2: {2025-10-01: 68_994}
+  3: {2025-10-01: 91_986}
+  4: {2025-10-01: 114_978}
+  5: {2025-10-01: 137_970}
+22:
+  1: {2025-10-01: 46_770}
+  2: {2025-10-01: 70_158}
+  3: {2025-10-01: 93_546}
+  4: {2025-10-01: 116_934}
+  5: {2025-10-01: 140_310}
+23:
+  1: {2025-10-01: 47_550}
+  2: {2025-10-01: 71_322}
+  3: {2025-10-01: 95_094}
+  4: {2025-10-01: 118_878}
+  5: {2025-10-01: 142_650}
+24:
+  1: {2025-10-01: 48_330}
+  2: {2025-10-01: 72_498}
+  3: {2025-10-01: 96_654}
+  4: {2025-10-01: 120_822}
+  5: {2025-10-01: 144_990}
+25:
+  1: {2025-10-01: 49_110}
+  2: {2025-10-01: 73_662}
+  3: {2025-10-01: 98_214}
+  4: {2025-10-01: 122_778}
+  5: {2025-10-01: 147_330}
+26:
+  1: {2025-10-01: 49_890}
+  2: {2025-10-01: 74_838}
+  3: {2025-10-01: 99_774}
+  4: {2025-10-01: 124_722}
+  5: {2025-10-01: 149_670}
+27:
+  1: {2025-10-01: 50_670}
+  2: {2025-10-01: 76_002}
+  3: {2025-10-01: 101_334}
+  4: {2025-10-01: 126_678}
+  5: {2025-10-01: 152_010}
+28:
+  1: {2025-10-01: 51_450}
+  2: {2025-10-01: 77_178}
+  3: {2025-10-01: 102_894}
+  4: {2025-10-01: 128_622}
+  5: {2025-10-01: 154_338}
+metadata:
+  unit: currency-USD
+  period: year
+  label: North Dakota LIHEAP annual income band upper limits
+  breakdown:
+    - range(1, 29)
+    - range(1, 6)
+  reference:
+    - title: FY2026 North Dakota LIHEAP Income Limits Full Table
+      href: https://liheapch.acf.gov/docs/2026/benefits-matricies/ND_BenefitMatrix_2026.xlsx
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/maximum_published_size.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/maximum_published_size.yaml
@@ -0,0 +1,10 @@
+description: North Dakota publishes income bands through this household size under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 28
+metadata:
+  unit: person
+  period: year
+  label: North Dakota LIHEAP largest published income-table household size
+  reference:
+    - title: FY2026 North Dakota LIHEAP Income Limits Full Table
+      href: https://liheapch.acf.gov/docs/2026/benefits-matricies/ND_BenefitMatrix_2026.xlsx
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/renter_annual_cap.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/renter_annual_cap.yaml
@@ -0,0 +1,37 @@
+description: North Dakota caps annual heat-in-rent assistance at these amounts by primary fuel under the Low Income Home Energy Assistance Program.
+# Unknown building fuel has no supported amount; zero is a calculation
+# limitation, not a legal cap or ineligibility rule for heat-in-rent households.
+UNSPECIFIED:
+  2025-06-01: 0
+ELECTRICITY:
+  2025-06-01: 1_500
+NATURAL_GAS:
+  2025-06-01: 700
+FUEL_OIL:
+  2025-06-01: 2_200
+# Manual 415-30-15-01 assigns kerosene, wood, coal and remaining fuels to Other.
+KEROSENE:
+  2025-06-01: 700
+PROPANE:
+  2025-06-01: 1_750
+WOOD:
+  2025-06-01: 700
+COAL:
+  2025-06-01: 700
+SOLAR:
+  2025-06-01: 700
+OTHER:
+  2025-06-01: 700
+NONE:
+  2025-06-01: 0
+metadata:
+  unit: currency-USD
+  period: year
+  label: North Dakota LIHEAP annual heat-in-rent benefit cap
+  breakdown:
+    - heating_type
+  reference:
+    - title: Energy Assistance Policy Manual 415-30-30, Renter Heating Benefit Table and Yearly Cap
+      href: https://www.nd.gov/dhs/policymanuals/415/415_30_30.htm
+    - title: Energy Assistance Policy Manual 415-30-15-01, Computation
+      href: https://www.nd.gov/dhs/policymanuals/415/415_30_15_01.htm
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/shares.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/shares.yaml
@@ -0,0 +1,10 @@
+description: North Dakota pays these shares of heating costs in successive income bands under the Low Income Home Energy Assistance Program.
+values:
+  2024-10-01: [1, 0.95, 0.85, 0.65, 0.45]
+metadata:
+  unit: list
+  period: year
+  label: North Dakota LIHEAP heating expense shares
+  reference:
+    - title: Energy Assistance Policy Manual 415-30-10, LIHEAP Share Percentage Table
+      href: https://www.nd.gov/dhs/policymanuals/415/415_30_10.htm
diff --git a/policyengine_us/parameters/gov/states/nd/dhs/liheap/smi_band_limits.yaml b/policyengine_us/parameters/gov/states/nd/dhs/liheap/smi_band_limits.yaml
@@ -0,0 +1,10 @@
+description: North Dakota uses these state median income shares to define benefit bands under the Low Income Home Energy Assistance Program.
+values:
+  2024-10-01: [0.2, 0.3, 0.4, 0.5, 0.6]
+metadata:
+  unit: list
+  period: year
+  label: North Dakota LIHEAP state median income band upper limits
+  reference:
+    - title: Energy Assistance Policy Manual 415-30-10, LIHEAP Share Percentage Table
+      href: https://www.nd.gov/dhs/policymanuals/415/415_30_10.htm
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Add North Dakota LIHEAP (nd_liheap): FY2026 regular heating benefit paying 45% to 100% of the annual heating bill by state median income band, with heat-in-rent payments.