Skip to content

Count the whole household's income for New York's real property tax credit - #11170

Merged
DTrim99 merged 3 commits into
mainfrom
ny-real-property-tax-credit-household-income
Nov 20, 2026
Merged

DTrim99 merged 3 commits into
mainfrom
ny-real-property-tax-credit-household-income

Conversation

@DTrim99

@DTrim99 DTrim99 commented Nov 19, 2026 •

Copy link
Copy Markdown
Collaborator

Part of #10812 (state credit income audit).

What was wrong

ny_household_gross_income is the income measure for New York's real property tax credit (Form IT-214) through tax year 2024; from 2025 the credit uses federal AGI. The variable's own documentation admitted two problems:

  1. Whose income. It summed one tax unit. N.Y. Tax Law 606(e)(1)(C) defines household gross income as "the aggregate adjusted gross income of all members of the household", and 606(e)(1)(B) makes the household the claimant "and all other persons, not necessarily related, who have the same residence and share its furnishings, facilities and accommodations". The 2024 IT-214 Step 3 asks for "the total of all amounts, even if not taxable, that you, your spouse (if married), and all other household members received" (2024 IT-214, page 2), and the line 7 instructions say household members are "all who share your residence ... whether they are related to you or not" (2024 IT-214-I, page 2). Other tax units in the home were left out, and so was a tax unit dependent's own AGI, because the return's AGI leaves out dependents' income.
  2. Missing income. It added only nontaxable Social Security, SSI and tax-exempt interest to AGI. Each item below is named in 606(e)(1)(C) and on a 2024 IT-214 line (the form, page 2, and the instructions, page 2, both linked above):
Added 2024 IT-214 line 606(e)(1)(C)
veterans_benefits 11, "veterans disability pensions" "veterans' disability pensions"
tax_exempt_pension_income 13, "Pensions and annuities ... not included on lines 9 through 12" "the gross amount of any pension or annuity benefits to the extent not included in such adjusted gross income"
tanf_person, general_assistance, ny_ssp 14, "cash public assistance and relief" "the amount of cash public assistance and relief, other than medical assistance for the needy"
workers_compensation 15, "workers' compensation" "workers' compensation"
child_support_received 15, "support money, including foster care support payments" "support money not included in adjusted gross income"
tax_exempt_disability_benefits 15, "the gross amount of loss-of-time insurance" "the gross amount of 'loss-of-time' insurance"
section_911_excluded_income 15, "income earned abroad exempted by section 911 of the IRC" "earned income from sources without the United States excludable from federal gross income by section nine hundred eleven"

I read the 2024 IT-214 and IT-214-I on tax.ny.gov directly. The statute text is from nysenate.gov.

What changes

ny_household_gross_income now builds lines 9 to 15 per person and sums them over the PolicyEngine household; every tax unit in the household gets that total.

  • Line 9: each tax unit's ny_recomputed_federal_agi counts once, on its head, plus each tax unit dependent's dependent_adjusted_gross_income.
  • Line 11: untaxed Social Security now subtracts a dependent's dependent_taxable_social_security (which their own AGI holds), so a dependent's Social Security counts once. Plus veterans_benefits.
  • Lines 12 to 15: the existing SSI and tax-exempt interest, plus the items in the table. TANF is paid to the SPM unit, so the formula uses tanf_person (each member's equal share), which sums back to the unit's TANF over the household. section_911_excluded_income is a tax unit amount and counts on the head.
  • Household amounts reach each tax unit through its members (person.household.sum, then the tax unit's members); nothing is mapped through map_to.
  • The documentation's list of omissions is replaced by what is still left out (below), and the references now cite the statute, the 2024 instructions and the 2024 form.

Unrelated roomers. 606(e)(1)(B) leaves out "a tenant, subtenant, roomer or boarder who is not related to the qualified taxpayer". The model can't tell them apart: no input marks a member as a tenant, roomer or boarder. (is_related_to_head_or_spouse isn't enough, because an unrelated member who shares the home is still a household member.) So their income counts. The documentation says so.

Who is affected

Only tax years through 2024, and only New York filers near the credit's $18,000 household gross income limit. Household gross income rises (never falls) for:

  • households with more than one tax unit, such as an adult child or parent filing their own return;
  • tax units whose dependents have their own income;
  • anyone with workers' compensation, child support, veterans' benefits, tax-exempt pensions, TANF, general assistance, State Supplement Program payments, tax-exempt disability benefits or section 911 income.

For them the real property tax credit falls or ends, so New York income tax rises (or the refund falls). Nothing changes from 2025, when the credit keys on federal AGI.

Tests

Moved from #10812 (ny_household_gross_income_audit.yaml) into ny_household_gross_income.yaml, with the "Main:" values and audit framing dropped:

  • Workers' compensation (9,000), child support (8,000), veterans' benefits (11,000), a tax-exempt pension (7,000), general assistance (7,400), tax-exempt disability benefits (8,000) and section 911 income (9,000). Before this PR each gave 5,000.
  • The household case, rewritten as the review asked: the parent is now 64 instead of 70, because at 70 PolicyEngine pays the parent SSI, which the model already counts. Age isn't read by the variable. Expected stays [11,000, 11,000]; before this PR, [5,000, 6,000].

Added in ny_household_gross_income.yaml:

  • TANF of 2,400 for a parent and child: 7,400.
  • A 70-year-old living alone: SSI 11,316 + State Supplement Program 1,044 = 12,360.
  • The original household case at age 70: the parent's SSI 9,326 and State Supplement Program payment 276 count on both returns, [20,602, 20,602].
  • A dependent with 30,000 of wages and 10,000 of Social Security: the dependent's AGI is 35,350 (5,350 taxable Social Security), the untaxed 4,650 is added on line 11, and household gross income is 45,000, with the taxable part counted once.

Added in ny_real_property_tax_credit.yaml (2024, at the $18,000 limit and one dollar above):

  • Workers' compensation brings income to exactly 18,000: credit 41. At 18,001: 0.
  • An adult child's income on their own return brings the household to exactly 18,000: the parent's credit is 41 (on the parent's income alone it was 67). At 18,001: 0 for both returns.

Changed in ny_real_property_tax_credit.yaml:

  • "2024 - dependent aged 66 makes the elderly maximum cap apply": ny_household_gross_income 13,316 → 13,592. The aged dependent's State Supplement Program payment for living with others, 23 × 12 = 276, now counts on line 14. The credit stays 154: rate 0.06, threshold 815.52, 50% of the 9,184.48 excess is 4,592.24, capped at the 13,001-14,000 elderly maximum of 154.

Not in this PR

Other New York real property tax credit gaps from the #10812 audit, left for later:

  • Line 10: New York additions other than tax-exempt interest (414(h) contributions and NYC flexible benefits, ny_other_additions).
  • Line 15: nontaxable strike benefits.
  • Line 13: railroad retirement benefits outside AGI, which open PR Count railroad benefits in state tax worksheets, income tests and limits as each state's law does #10722 covers.
  • Two readings the audit left open: nontaxable Roth and other retirement-account distributions (line 13), and alimony outside AGI under post-2018 divorces ("support money").
  • No input exists for foster care payments, gain excluded from AGI, or part-year household membership.

Rent, age and one credit per household (added after review): through 2024 the credit also uses the rent paid by all household members (2024 IT-214 line 19) and the 65-or-older limit when any household member is 65 or older (606(e)(6)(A)), and only one tax unit per household receives it (2024 IT-214-I, page 1, and the line 33 instructions, page 3). ny_real_property_tax_credit_potential computes each tax unit's credit on household amounts, and ny_real_property_tax_credit_claimant gives it to the tax unit with the largest potential credit, then the household head's, then person order. Property tax and assessed value stay with the tax unit that owns the home (606(e)(1)(E)). From 2025 each tax unit's credit is unchanged.

Tested on Modal: run w1-ny-a, 255/255 passed: 253 YAML test files (every New York test, all partner files, and the Yonkers, local-tax and abolish-federal-income-tax files that read New York income tax) and 2 pytest files (test_source_conflicts.py, test_claimable_filer_ny_invariants.py). No partner test changed.

🤖 Generated with Claude Code

@DTrim99
DTrim99 requested a review from hua7450 November 19, 2026 23:28

@hua7450 hua7450 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, David. Household gross income now matches Tax Law 606(e)(1)(B)-(C) and the 2024 IT-214: the federal AGI of every household member plus the listed items, with no double counting and no cycle from the new TANF and State Supplement reads. Only ny_real_property_tax_credit reads it, through 2024, and no existing case's inputs changed. One fix before I approve.

Before merge

  1. The credit's other inputs are still the tax unit's. ny_real_property_tax_credit.py reads rent and the age tier per tax unit (lines 21-34 and 72-74) while income is now the household's. In two-return households that moves the result further from the statute than main (hand traces, not run):

    • Parent aged 70 on their own return with 12,000 of Social Security; adult child aged 40 with 3,000 of wages, paying 4,800 of rent. Statute: 112.50, since 606(e)(6)(A) gives the household the 65-or-older limit. Main: 71. This PR: 47.
    • Two adults on their own returns, 8,000 of wages each, each paying 2,400 of a 4,800 rent. Statute: one credit of 45 on the household's rent (IT-214 line 19, "rent you and all members of your household paid"). Main: 61 on each return. This PR: 0 on each.

    Please move the renter's rent and the age tier to the household in this PR, or tell me if you would rather hold the income change until they can move together.

Optional

  • Two statutory items with inputs. 606(e)(1)(C) names "nontaxable strike benefits" and takes AGI with the section 612(b) modifications (IT-214 line 10). tax_exempt_strike_benefits and ny_additions both exist and are outside federal AGI.
  • Line 11 conflict. The instruction nets Medicare premiums from Social Security; the statute counts the gross amount. The model follows the statute, but the PR's quote stops before that clause and there is no source_conflicts/candidates.yaml entry.
  • Safety Net Assistance. Line 14 reads general_assistance but not ny_safety_net_assistance, New York's own input. Reading both could double count, so it needs one choice or a sentence of documentation.
  • Tests. No pre-2025 joint-return case, no cross-unit loss case (the PR body's "never falls" is wrong when another member's AGI is negative) and no case with rent on two tax units.
  • "Not yet added" list. It omits railroad retirement, excluded gain, foster care payments and part-year membership. Open PR 10722 edits the same variable for railroad benefits.

@DTrim99
DTrim99 force-pushed the ny-real-property-tax-credit-household-income branch from 8198e98 to 1ad017e Compare November 20, 2026 16:17
@DTrim99

DTrim99 commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator Author

Thanks, Ziming. I took your first option and moved rent and the age tier to the household in this PR, with one credit per household. Fixed in 1ad017e, rebased on main.

Fixed (your "Before merge" item)

Through 2024 (the years uses_household_gross_income is true):

  • Rent: the rent paid by all household members (606(e)(1)(F)(i); 2024 IT-214 line 19).
  • Age tier: the 65-or-older limit applies when any household member is 65 or older (606(e)(6)(A); 2024 IT-214-I, p. 1).
  • One credit per household: only one tax unit receives it (2024 IT-214-I, p. 1, "Only one credit is allowed per household"). The new ny_real_property_tax_credit_potential computes each tax unit's credit on household amounts. The new ny_real_property_tax_credit_claimant gives it to the tax unit with the largest potential, then the household head's, then person order (following the Arizona property tax credit). ny_real_property_tax_credit is the potential times the claimant flag.
  • Property tax and assessed value stay with the tax unit that owns the home (606(e)(1)(E)), so the homeowner's unit wins.
  • From 2025: each tax unit's credit is unchanged from main.

Your two traces are now tests (2024):

Case Household gross income Credit
Parent 70 with 12,000 Social Security; child 40 with 3,000 wages paying 4,800 rent 15,000 112.50 on one return (elderly cap)
Two adults with 8,000 wages each, each paying 2,400 of a 4,800 rent 16,000 45 on one return

A new claimant test file covers three more cases: the homeowner's unit wins (137), a tie goes to the household head (45), and in 2025 each unit claims its own (70 and 70).

I also pointed the us-ny:real-property-credit-claimable-spouse register entry at the new potential variable, and updated the PR body.

Skipped (optional, not in this round): strike benefits and the 612(b) modifications, the line 11 Medicare entry, the Safety Net Assistance choice, the extra tests and the "Not yet added" list. One thing left as is: line 7 of the 2024 IT-214-I names a 65+ member "who is filing Form IT-214", while the code follows p. 1 and counts any 65+ household member. That could become a register entry.

Verification: the NY credits tests pass locally after the rebase (304/304), as do the source-conflicts and NY claimable-filer tests. An independent check confirmed both traces and the claimant cases by hand, and the IT-214-I quotes. It also ran a combined six-household simulation, including a three-unit household whose head's unit is ineligible.

@DTrim99
DTrim99 requested a review from hua7450 November 20, 2026 16:18

@hua7450 hua7450 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, David. The household fix holds against 606(e) and the 2024 IT-214 and IT-214-I. Through 2024, rent and the 65-or-older limit come from the whole household, property tax and assessed value stay with the owner's tax unit, and only one tax unit claims. The claimant order (largest potential, then household head, then person order) is a division the members could agree to, and the potential never reads the claimant. Both traces are now tests (112.50 and 45), the five new expected values derive by hand, and 2025 on matches main. One small fix before I approve.

Before merge

  1. Record the line 7 reading. You flagged it yourself: the code follows 606(e)(6)(A) ("able to meet the qualifications of a qualified taxpayer and one of them is sixty-five") and IT-214-I page 1 ("at least one member"), while line 7 of the 2024 instructions limits the elderly limit to a 65+ member "who is filing Form IT-214". It only changes money when the 65+ member is a claimed dependent, who can't file a claim. Example: an adult child (40, wages 3,000, rent 4,800) who claims a 70-year-old parent with 12,000 of Social Security gets 112.50 under the statute and 47 under line 7. Keeping the statute is right; please add a source_conflicts/candidates.yaml entry and a 2024 case with that household.

Optional

  • Rent paid inside an owner-occupied household. Every tax unit's potential adds household rent and tests it against the $450-a-month tenant cap, so rent a member pays to the owning member joins the owner's claim. A parent (70) who owns with 1,500 of property tax, and an adult child on their own return paying the parent 500 a month, now gets 0, where the owner's own computation gives 137. 606(e)(7)(D) bars only "a tenant", and that rent isn't paid "for the right of occupancy" by the household. It only arises if the child's payment is entered as rent.
  • References. ny_real_property_tax_credit_potential.py lists the 2024 IT-214-I twice (#page=1 and #page=2), and ny_real_property_tax_credit_claimant.py cites page 1 while its comment relies on line 33 (page 3).
  • uses_household_gross_income now also switches household rent, the age limit and the one-credit rule; its description mentions only income.
  • Claimant code. It copies the Arizona claimant line for line; Montana and Utah have the same rule, so a shared helper could serve all four.
  • Still open from the first round: strike benefits and the 612(b) additions, the line 11 Medicare conflict, ny_safety_net_assistance, a pre-2025 joint return and a cross-unit loss case, and the "Not yet added" list.

DTrim99 and others added 3 commits November 20, 2026 14:05
…redit

IT-214 household gross income (used through 2024) now sums every member of
the household, including other tax units and dependents' own AGI, and adds
workers' compensation, child support, veterans' benefits, tax-exempt
pensions, TANF, general assistance, State Supplement Program payments,
tax-exempt disability benefits and section 911 excluded income, per Tax Law
606(e)(1)(B)-(C) and the 2024 IT-214 lines 9 to 15.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… real property tax credit, one credit per household

Through 2024 the credit now counts rent paid by every household member,
applies the 65-or-older limit when any household member is 65 or older,
and allows one credit per household (Tax Law 606(e)(1)(F)(i), 606(e)(6)(A)).
New ny_real_property_tax_credit_potential holds the per-unit amount and
ny_real_property_tax_credit_claimant picks the one claiming tax unit; every
tax unit still claims from 2025. Points the source-conflict candidate
us-ny:real-property-credit-claimable-spouse at the potential variable.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…n aged dependent

Register candidate us-ny:real-property-credit-aged-dependent for the
2024 rule that only a household member filing Form IT-214 counts on
line 7, mark the pre-2025 age test with the candidate comment, and add
a 2024 case where an aged parent claimed as a dependent gives the
household the elderly limit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@DTrim99
DTrim99 force-pushed the ny-real-property-tax-credit-household-income branch from 1ad017e to 9bee87d Compare November 20, 2026 19:26
@DTrim99

DTrim99 commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator Author

Thanks, Ziming. Fixed in 9bee87d, rebased on main.

Fixed (your "Before merge" item)

  • Line 7 reading recorded. New register entry us-ny:real-property-credit-aged-dependent in source_conflicts/candidates.yaml, placed after us-ny:real-property-credit-claimable-spouse.
    • It covers 2024, follows the statute, and is open with PR 11170.
    • The statute side quotes 606(e)(6)(A) and IT-214-I p. 1 ("at least one member of your household is age 65 or older").
    • The instruction side quotes line 7, p. 2 (a 65+ member "who is filing Form IT-214"), and the line 32 chart, p. 3.
    • The age test in ny_real_property_tax_credit_potential.py now carries a # Candidate: comment pointing to it.
  • 2024 case with your household: an adult child aged 40 with 3,000 of wages and 4,800 of rent claims a 70-year-old parent with 12,000 of Social Security.
    • Household gross income is 15,000; 1,200 − 975 = 225, half is 112.50, under the elderly cap of 137. That's 112.50 under the statute; line 7 would give 47.
    • The case also asserts the parent's SSI and state supplement are 0 (outputs, not pinned inputs). Countable income of 980 a month is over 943, and over 943 + 23 for living with others.
    • If the model ever treated the parent as living alone, the supplement would add $50 a month and the credit would drop to 93, so those assertions are worth keeping.

Skipped (optional, not in this round): rent a member pays to the owning member, the duplicate IT-214-I reference and claimant page cite, the uses_household_gross_income description, a shared claimant helper, and the open items from the first round.

Verification: the NY credits tests (305/305) and the source-conflicts and dead-URL tests (291/291) pass locally after the rebase. An independent check confirmed the entry's quotes against IT-214-I pages 1-3 and the 606(e) text, and the 112.50 by hand.

@DTrim99
DTrim99 requested a review from hua7450 November 20, 2026 19:27

@hua7450 hua7450 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, David. Both items are in. The us-ny:real-property-credit-aged-dependent entry quotes 606(e)(6)(A) and IT-214-I page 1 against line 7 and the line 32 chart, follows the statute, and is open with this PR. The new 2024 case with a claimed 70-year-old parent comes to 112.50, which I checked by hand: 1,200 − 975 = 225, half is 112.50, under the $137 elderly limit. Apart from that commit, the rebase changed nothing in the PR's diff. Approving.

@DTrim99
DTrim99 merged commit 5057534 into main Nov 20, 2026
38 checks passed
@DTrim99
DTrim99 deleted the ny-real-property-tax-credit-household-income branch November 20, 2026 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants