Verifiable US tax oracle for AI agents: cited, machine-checkable federal and state tax computation
Scored across 15 tools
Most tools have clearly distinct purposes: calculation tools (business, fiduciary, individual, state) are separated by entity type, and lookup/verification tools serve different retrieval needs. However, verify_fact and verify_tax_claim both check claims against the law and could be confused, though one focuses on dollar amounts and the other on tax amounts. Also, calculate_tax and compute_return both handle individual returns but differ in output granularity.
All tool names follow a consistent snake_case verb_noun pattern (calculate_business_tax, list_input_facts, search_tax_rules). The verbs are descriptive and predictable, making the set easy to navigate.
15 tools is within the ideal range for a domain as complex as tax law. Each tool covers a distinct aspect (calculation, lookup, verification, dependency, cliffs, tips), and none feels redundant or extraneous.
The tool set provides comprehensive coverage for individual, business, and fiduciary tax computation, state returns, dependency determination, rule lookup, parameter verification, and edge-case analysis. There are no obvious gaps that would cause agent failures for typical tax questions.
Compute US federal BUSINESS-ENTITY tax from the same cited corpus: check-the-box entity classification, Form 1120 corporate income tax (§ 179/168(k)/174A/163(j)/DRD/NOL, § 250, GBC/FTC/BEAT), S-corp entity taxes, corporate estimates, the § 4501 buyback excise, AET and PHC taxes. Individual returns → calculate_tax. Unknown keys are rejected; unmodeled territory refuses loudly with the reason.
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | REQUIRED for computation: the law-in-force date — use the intended tax year's year-end (e.g. "2025-12-31" for TY2025). Omitting it is an error, never a default. | |
| target | No | rule to derive (default: us.federal.corp.entity_level_income_tax — the classification-aware entity income tax). Other targets: us.federal.corp.entity_classification, .taxable_income, .income_tax_after_credits, .beat, .estimated.quarterly_payment, .stock_buyback_excise, .accumulated_earnings_tax, .phc_tax, .s_corp_entity_taxes | |
| corpNCTI | No | TY2025: the § 951A GILTI inclusion (with its § 78 gross-up); TY2026+: net CFC tested income (NCTI, OBBBA). The § 250 deduction applies 50% (2025) / 40% (2026+). The inclusion itself is GROSS INCOME (§ 951A(a)) — it must also be in corpGrossIncome with its § 78 gross-up; this fact drives only the § 250 deduction and FTC basket. The per-CFC tested-income aggregation is not modeled. In dollars. | |
| corpFDDEI | No | TY2025: foreign-derived intangible income (FDII); TY2026+: foreign-derived deduction eligible income (FDDEI, OBBBA — QBAI abolished). The § 250 deduction applies 37.5% (2025) / 33.34% (2026+). In dollars. | |
| includeProof | No | include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned. | |
| corpPHCIncome | No | Personal holding company income (§ 543: dividends, interest, royalties, annuities, certain rents). In dollars. | |
| llcMemberCount | No | Number of members (owners) of the LLC — one member defaults to disregarded-entity treatment, two or more to partnership (Treas. Reg. § 301.7701-3(b)(1)). | |
| qreCurrentYear | No | Qualified research expenses for the current year (§ 41(b); § 41(d) qualification attested). In dollars. | |
| corpGrossIncome | No | The corporation's gross income (§ 61), INCLUDING any dividends received, any § 951 subpart F and § 951A NCTI/GILTI inclusions with their § 78 gross-ups (§ 951A(a) is a gross-income INCLUSION — the § 250 deduction is computed separately from corpNCTI), and any § 245A-eligible foreign-sub dividends. In dollars. | |
| corpIsREITorRIC | No | The corporation is a real estate investment trust (§ 856) or regulated investment company (§ 851). REFUSES — their dividends-paid deduction and distribution requirements are not modeled. | |
| entityLegalForm | No | The business's state-law legal form: a limited liability company, or a state-law corporation (a per-se corporation under Treas. Reg. § 301.7701-2(b)(1)). | |
| corpCapitalGains | No | The corporation's capital gains for the year (§ 1211(a): losses offset only these; net gain is ordinary-rate income for a corporation). In dollars. | |
| corpPriorYearTax | No | Tax shown on the corporation's preceding-year return (§ 6655(d) prior-year prong; unavailable if that year showed zero tax or was short). In dollars. | |
| corpCapitalLosses | No | The corporation's capital losses for the year, including prior-year § 1212(a) carryovers being used (allowed only to the extent of capital gains). In dollars. | |
| corpDividendsPaid | No | Dividends paid during the year (the § 561 dividends-paid deduction for the accumulated-earnings computation). In dollars. | |
| corpTaxableIncome | No | The C corporation's taxable income BEFORE the § 250 deduction, if already computed — used as-is when provided. Leave at 0 to have the engine compute it from corpGrossIncome and the deduction components (charitable/DRD/NOL machinery). CONTRACT: the § 250 deduction is computed separately from corpFDDEI/corpNCTI and subtracted by the tax rule — an AS-FILED Form 1120 line 30 already nets out § 250, so when providing corpFDDEI/corpNCTI enter the pre-§ 250 amount here (line 30 plus the § 250 deduction as filed), never the net. In dollars. | |
| qreAvgPrior3Years | No | Average annual qualified research expenses over the 3 preceding years — 0 means no prior QREs (the 6% startup rate of § 41(c)(4)(B) applies). In dollars. | |
| corpSection179Cost | No | Cost of § 179 property the corporation elects to expense — including qualified real property (roofs, HVAC, fire/security systems on nonresidential real property, § 179(d)(1)(B)(ii)) that § 168(k) cannot reach. Must NOT also be in corpEquipmentPurchases; EXCLUDE passenger automobiles and sport utility vehicles (the § 280F caps and the § 179(b)(5) SUV cap are not modeled). In dollars. | |
| corpStockIssuedFMV | No | Fair market value of stock issued by the corporation during the taxable year (including to employees) — netted against repurchases under § 4501(c)(3). In dollars. | |
| sCorpGrossReceipts | No | The S corporation's gross receipts for the year (§ 1375). In dollars. | |
| corpFiscalYearFiler | No | The corporation uses a FISCAL taxable year (or files a § 443 short-period return). Fiscal and short years are not modeled — the OBBBA parameters (§ 250 rates, § 59A 10.5%, § 960(d) 90%, § 448(c) $32M, the § 170(b)(2) 1% floor) apply by the taxable year's BEGINNING date, and § 443(b) annualization / § 15 proration are not encoded. | |
| corpForeignResearch | No | FOREIGN research or experimental expenditures paid this year — capitalized and amortized over 15 years (§ 174; first-year deduction is 1/30 under the midpoint convention). In dollars. | |
| corpNOLCarryforward | No | Net operating loss carryforward available this year (§ 172: deduction limited to 80% of taxable income before the NOL; post-TCJA, no carrybacks). In dollars. | |
| employeeAnnualWages | No | One employee's annual wages, for the employer-side payroll-tax target (§ 3111 FICA + FUTA). In dollars. | |
| corpDomesticResearch | No | Domestic research or experimental expenditures — currently deductible under § 174A (OBBBA, permanent from 2025). In dollars. | |
| corpDrdOwnershipTier | No | Ownership of the dividend-paying corporation: under 20% (50% DRD), 20–80% (65% DRD), or 80%+ affiliated (100% DRD, § 243(a)(3)). | |
| corpForeignTaxesNCTI | No | Foreign taxes attributable to the § 951A basket (GILTI/NCTI) — the § 960(d) deemed-paid credit takes the 80% (2025) / 90% (2026+, OBBBA) allowance, no carryovers. In dollars. | |
| corpTIThrough3Months | No | Corporate taxable income for the first 3 months (§ 6655(e) annualization, installments 1-2). In dollars. | |
| corpTIThrough6Months | No | Corporate taxable income for the first 6 months (§ 6655(e) annualization, installment 3). In dollars. | |
| corpTIThrough9Months | No | Corporate taxable income for the first 9 months (§ 6655(e) annualization, installment 4). In dollars. | |
| corpDividendsReceived | No | Dividends received from other taxable domestic corporations (§ 243 DRD; must also be included in corpGrossIncome). Enter only dividends on stock meeting the § 246(c) holding period (held more than 45 days during the 91-day window around the ex-dividend date; 90/181 for certain preferred) — attested; § 1059 extraordinary-dividend basis reduction not modeled. In dollars. | |
| sCorpNetPassiveIncome | No | Passive investment income net of directly-connected deductions (§ 1375(b)(2)). In dollars. | |
| sCorpShareholderCount | No | Number of shareholders, counting married couples and § 1361(c)(1) family members as one (§ 1361(b)(1)(A): may not exceed 100). | |
| sCorpTaxableIncomeAsC | No | The S corporation's taxable income computed as if it were a C corporation (§§ 1374(b)(1)/1375(b)(1)(B) cap). In dollars. | |
| corpBaseErosionTestMet | No | The corporation's base erosion percentage is 3% or more (2% for banks/securities dealers) — one of the two § 59A applicable-taxpayer tests. BEAT applies only to $500M+ multinationals. | |
| corpEquipmentPurchases | No | Cost of qualified § 168(k) property acquired AND placed in service this year (acquired after January 19, 2025 — 100% bonus depreciation, OBBBA-permanent). EXCLUDE passenger automobiles (the § 280F luxury-auto caps are not modeled) and anything entered in corpSection179Cost. In dollars. | |
| corpIsLargeCorporation | No | The corporation had taxable income of $1,000,000 or more in any of the 3 preceding taxable years (§ 6655(g)(2) 'large corporation' — may not use the prior-year safe harbor). | |
| corpOrdinaryDeductions | No | Ordinary business deductions (salaries, rents, prior-year amortization, …) — everything EXCEPT charitable contributions, the dividends-received deduction, and NOLs, which have their own limited rules. Enter compensation already limited by § 162(m) (no deduction for a covered employee's remuneration over $1,000,000 at a publicly held corporation — not modeled, attested). In dollars. | |
| corpOwnedByFiveOrFewer | No | More than 50% of the stock's value was owned (directly or via § 544 attribution) by 5 or fewer individuals during the last half of the year (§ 542(a)(2)). | |
| filedForm2553SElection | No | The entity filed a timely Form 2553 S election under § 1362(a)(1) (for an eligible entity this also deems association classification, Reg. § 301.7701-3(c)(1)(v)(C)). | |
| generalBusinessCredits | No | Aggregate current-year § 38(b) general business credits (e.g. the § 41 research credit target's result) — limited under § 38(c). In dollars. | |
| corpAvgGrossReceipts3yr | No | 3-year-average annual gross receipts (§ 448(c) test: $31M for 2025, $32M for 2026 — at or below it the § 163(j) limit does not apply). In dollars. | |
| corpForeignTaxesGeneral | No | Creditable foreign income taxes in the § 904(d) GENERAL basket. In dollars. | |
| corpStockRepurchasedFMV | No | Fair market value of the corporation's own stock repurchased (§ 317(b) redemptions and economically similar transactions) during the taxable year, for the § 4501 excise. In dollars. | |
| corpIsCoveredCorporation | No | The corporation is a 'covered corporation' for the § 4501 stock-repurchase excise tax: a domestic corporation whose stock is traded on an established securities market (§ 4501(b)). | |
| corpSection245ADividends | No | Foreign-source portion of dividends received from specified 10-percent-owned foreign corporations, eligible for the § 245A participation-exemption DRD (100%). Must also be included in corpGrossIncome. Attested by entry: US-shareholder status, NOT a § 245A(e) hybrid dividend, and the § 246(c)(5) 365-day holding period met; no foreign tax credit is allowed for the deducted portion (§ 245A(d)) — keep these taxes out of the FTC inputs. In dollars. | |
| sCorpHasAccumulatedEandP | No | The S corporation has accumulated earnings and profits from C-corporation years at the close of the year (§ 1375 applies only then). | |
| corpAccumulatedEandPStart | No | Accumulated earnings and profits at the close of the PRECEDING year (§ 535(c)(2) minimum-credit offset). In dollars. | |
| corpIsPersonalServiceCorp | No | The corporation's principal function is services in health, law, engineering, architecture, accounting, actuarial science, performing arts, or consulting (§ 535(c)(2)(B): $150,000 minimum credit instead of $250,000). | |
| filedForm8832CorpElection | No | The entity filed a Form 8832 election to be classified as an association taxable as a corporation (Treas. Reg. § 301.7701-3(c)). | |
| corpBaseErosionTaxBenefits | No | Base erosion tax benefits for the year (§ 59A(c)(2)) — include the base-erosion percentage of any NOL deduction (§ 59A(c)(1)(B)). Added back to reach modified taxable income. In dollars. | |
| corpUndistributedPHCIncome | No | Undistributed personal holding company income (§ 545: taxable income adjusted, less federal taxes and the dividends-paid deduction). In dollars. | |
| sCorpRecognizedBuiltInGain | No | Net recognized built-in gain during the § 1374(d)(7) 5-year recognition period after a C-to-S conversion (0 if the period has passed or there was no conversion). In dollars. | |
| corpBusinessInterestExpense | No | Business interest expense (§ 163(j): limited to 30% of EBITDA-based ATI unless the § 448(c) gross-receipts test is met). In dollars. | |
| corpCharitableContributions | No | The corporation's charitable contributions — current-year gifts plus allowable prior-year § 170(d)(2) carryovers being used (both subject to the same ceiling and, from 2026, the OBBBA floor). In dollars. | |
| corpFilesConsolidatedReturn | No | The corporation joins a consolidated return (§§ 1501-1504) — intercompany eliminations and SRLY rules are not modeled, so this refuses. | |
| corpReasonableNeedsRetention | No | Earnings retained for the reasonable needs of the business (§§ 535(c)(1), 537 — documented needs; part of the accumulated earnings credit). In dollars. | |
| sCorpHasMultipleStockClasses | No | The corporation has more than one class of stock (§ 1361(b)(1)(D); differences in voting rights alone do not create a second class, § 1361(c)(4)). | |
| sCorpPassiveInvestmentIncome | No | The S corporation's passive investment income — royalties, rents, dividends, interest, annuities (§ 1375(b)(3)). In dollars. | |
| sCorpHasIneligibleShareholder | No | Any shareholder is ineligible under § 1361(b)(1)(B)–(C): a nonresident alien, or an entity other than an estate or eligible trust/exempt organization. | |
| corpForeignSourceIncomeGeneral | No | Foreign-source taxable income in the general basket (§ 904 limitation numerator; § 861 expense allocation attested). In dollars. | |
| corpAdjustedOrdinaryGrossIncome | No | Adjusted ordinary gross income (§ 543(b)(2)) — the 60% test base. In dollars. | |
| corpPortfolioDebtFinancedPercent | No | Average indebtedness percentage (0-100) of debt-financed portfolio stock (§ 246A) — reduces the 50%/65% DRD proportionally; 0 = not debt-financed. | |
| corpAvgAdjustedFinancialStatementIncome | No | 3-year-average adjusted financial statement income (§ 56A) — over $1 billion triggers the corporate AMT, which this engine refuses to approximate. In dollars. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must disclose behavioral traits. It does mention rejection of unknown keys and refusal for unmodeled territory, indicating the tool is strict and non-approximating. However, it does not mention side effects, required parameters like asOf, or the nature of the output. Given the lack of annotations, this is a reasonable disclosure but not exhaustive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single dense paragraph that front-loads the core scope, then lists the major covered areas, then points to the sibling tool and error behavior. Every sentence adds value; there is no repetition or filler. It is appropriately concise for a tool with 64 parameters and complex tax logic.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (64 parameters, no output schema), the description should explain what the tool returns and any required inputs. It does not mention the output format or the requirement for asOf (which the schema marks as REQUIRED). It also does not indicate whether the response is a single number or a structured object. This is a notable gap for a tool this complex, though the description does cover scope and error behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the input schema provides detailed descriptions for all 64 parameters including enums, defaults, and contractual notes (e.g., corpTaxableIncome's pre-§ 250 handling). The tool description itself adds no parameter-level semantics beyond noting 'Unknown keys are rejected', which is about validation rather than meaning. Per the rubric, a baseline of 3 applies when schema coverage is high.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool computes US federal business-entity taxes and enumerates the specific tax areas handled (Form 1120, S-corp taxes, buyback excise, AET, PHC, etc.). It also explicitly points to calculate_tax for individual returns, distinguishing it from that sibling. The verb 'compute' and the resource 'business-entity tax' are specific and unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly says 'Individual returns → calculate_tax', giving a clear alternative and when to use it. It also states 'Unknown keys are rejected; unmodeled territory refuses loudly with the reason', which tells agents when the tool will not compute and what to expect. This is explicit guidance for selecting this tool over siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Compute US federal income tax for an ESTATE or TRUST (Form 1041): the § 1(e) compressed brackets and § 642(b) exemption. Input is taxable income before the exemption, after the §§ 651/661 distribution deduction. Retained capital gains refuse loudly (§ 1(h) trust breakpoints not modeled). Grantor trusts belong on the grantor's individual return via calculate_tax.
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | REQUIRED for computation: the law-in-force date — use the intended tax year's year-end (e.g. "2025-12-31" for TY2025). Omitting it is an error, never a default. | |
| target | No | rule to derive (default: us.federal.fiduciary.income_tax). | |
| includeProof | No | include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned. | |
| fiduciaryType | No | Form 1041 filer type for the § 642(b) exemption: estate ($600), simple trust required to distribute all income currently ($300), or complex trust ($100). Grantor trusts do not file their own tax — use the grantor's individual return. | |
| fiduciaryLongTermGains | No | Net long-term capital gain retained by the estate/trust. Any positive amount REFUSES — the § 1(h) preferential breakpoints for estates and trusts are not modeled. In dollars. | |
| fiduciaryIncomeBeforeExemption | No | The estate/trust's taxable income BEFORE the § 642(b) exemption but AFTER the §§ 651/661 income-distribution deduction (the DNI machinery is attested by this input). In dollars. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It discloses a key failure mode—'Retained capital gains refuse loudly (§ 1(h) trust breakpoints not modeled)'—and scopes exactly which rules are modeled vs. not. It could additionally state that the tool is a pure computation with no side effects or describe the default response shape, but the disclosed refusal and scope limitations give meaningful behavioral information.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, zero filler. The purpose is front-loaded, followed by the critical input precondition, then the refusal behavior and alternative routing. Every sentence earns its place and the length is appropriate for a tool with complex tax-law scope.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a complex legal computation with six parameters and no output schema, the description covers the modeled rules, input semantics, exclusions, and alternative tool. The only gap is that it does not state the response format (e.g., that it returns the tax amount plus proof hashes), though the includeProof parameter describes the artifact behavior. This is a minor omission given the tool's clear purpose.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3 even without parameter detail in the description. The description does reinforce the key semantic of fiduciaryIncomeBeforeExemption ('after the §§ 651/661 distribution deduction') and the refusal condition, but these largely echo the schema's own field descriptions. It adds no meaning that the schema does not already convey.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb and resource: 'Compute US federal income tax for an ESTATE or TRUST (Form 1041)' and names the exact rules modeled (§ 1(e) brackets, § 642(b) exemption). It differentiates from the sibling calculate_tax by explicitly stating that grantor trusts should use calculate_tax instead, so an agent can disambiguate without opening schemas.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It specifies the exact input precondition: 'taxable income before the exemption, after the §§ 651/661 distribution deduction.' It gives an explicit when-not-to-use case with a named alternative ('Grantor trusts belong on the grantor's individual return via calculate_tax') and a hard exclusion for retained capital gains, which 'refuse loudly.' These are clear usage boundaries beyond what the schema provides.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Compute US federal INDIVIDUAL income tax (or balance due if withholding is given) from a content-addressed corpus of cited rules. NEVER estimate tax yourself — call this, and report ONLY numbers returned by oracle calls made with the real facts (never hand-check or approximate a line the oracle can compute: your recalled parameters may be stale). Negative result = refund. Returns the answer, every assumption made, and hashes that let anyone re-verify the full derivation offline. Facts are grouped (filing, income, retirement, credits, …) — fill the groups that apply; unknown keys are rejected, and the engine names any missing fact the target needs. When source documents CONFLICT on a value, do not silently pick one: compute both branches, disclose the conflict and your choice; an interview/confirmation answer (rollover, conversion, taxable-amount screens) usually reflects taxpayer intent better than a payer form's box code — prefer it and disclose. That heuristic covers FACTS only: LEGAL classifications (qualifying child vs other dependent, filing status, SSTB) follow the statute's tests, not intake checkbox labels — a generic 'claim dependent credit' flag does not convert a qualifying child into an ODC dependent. TRANSCRIBE documented amounts as given even when they look anomalous (e.g. state withholding in a no-income-tax state): disclose the anomaly, never delete or 'correct' a documented number from outside knowledge. If you believe an oracle result is wrong, report the ORACLE's number and note your dissent — never substitute your own: the corpus is primary-source-verified and your recollection is not. Business entities → calculate_business_tax; estates/trusts → calculate_fiduciary_tax; § 152 dependency → determine_dependent.
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | REQUIRED for computation: the law-in-force date — use the intended tax year's year-end (e.g. "2025-12-31" for TY2025). Omitting it is an error, never a default. | |
| state | No | state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo/us.wi/us.mn income_tax; parameters via lookup_tax_parameter) | |
| filing | No | who is filing: status, age/blindness, dependency, student status | |
| income | No | wages, interest, capital gains, unemployment, foreign earned income | |
| strict | No | strict mode for completed returns: if any transcribed document omits a box the return depends on (e.g. W-2 box 2 federal withholding), refuse with NEEDS_FACTS naming the box instead of treating it as $0. Default false — the $0 assumption is disclosed in documentNotes. | |
| target | No | rule to derive (default: net tax; balance due when payments_estimates.federalTaxWithheld is given). Determinations: us.federal.eligible.tips_deduction, us.federal.estimated.quarterly_payment, us.federal.estimated.safe_harbor_met | |
| credits | No | CTC/ODC counts, dependent care, saver's, adoption, education | |
| itemized | No | Schedule A: SALT, mortgage, medical, charitable | |
| documents | No | RAW document transcription (preferred over hand-mapped facts): W-2 boxes, 1099-R boxes/codes, SSA-1099 boxes, dependents' birth dates. SSA-1099s are first-class: box 5 sums into socialSecurityBenefits and box 6 into withholding, so the § 86 taxable-benefits worksheet runs on the transcribed total instead of a hand-mapped guess. The tool derives wages/withholding (incl. Form 8959 Part IV), box-3/5 wage coordination, dependent classifications, age facts, and early-distribution penalties deterministically — and errors if the same value is also passed as a hand-mapped fact. | |
| kiddie_tax | No | Form 8615 inputs for a child subject to § 1(g) | |
| retirement | No | social security, IRA/pension distributions, early-distribution penalty | |
| adjustments | No | IRA/HSA contributions, student-loan and car-loan interest | |
| includeProof | No | include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned. | |
| investor_amt | No | AMT preferences (ISO spread) and § 1202 QSBS exclusion | |
| tips_overtime | No | § 224 tips and § 225 overtime deductions (OBBBA) | |
| healthcare_ptc | No | § 36B premium tax credit / Form 1095-A reconciliation | |
| rentals_passive | No | Schedule E rentals/royalties + § 469 passive-loss netting (Form 8582 via us.federal.passive_loss_allowed) | |
| self_employment | No | Schedule C / K-1, QBI inputs, SE deductions, home office | |
| household_employer | No | Schedule H nanny/household-employee taxes | |
| payments_estimates | No | withholding, prior-year safe harbor, annualized installments |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden — and it discharges it richly. It discloses conflict-resolution behavior (compute both branches, disclose the choice), the facts-vs-legal-classification heuristic, transcription rules for anomalous amounts, and the dissent policy (report the oracle's number, never substitute your own). This is exactly the behavioral context an agent needs beyond what a schema could state.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is long (multiple paragraphs), but for a tool of this complexity nearly every sentence earns its place — the oracle fidelity rules, conflict handling, and transcription heuristics are all load-bearing behavioral constraints. Core purpose is front-loaded in the first sentence. Minor deduction for verbosity that could be trimmed without losing meaning.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description explains what the tool returns ('the answer, every assumption made, and hashes that let anyone re-verify the full derivation offline'). Given the enormous schema, it covers the behavioral contract, routing, and failure semantics (unknown keys rejected, missing facts named). Nothing an agent needs to invoke it correctly is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The schema itself carries exhaustive per-parameter meaning across hundreds of fields. The description adds only marginal group-level guidance ('fill the groups that apply; unknown keys are rejected, and the engine names any missing fact') rather than per-parameter detail — appropriate given the schema already does the heavy lifting, but not enough to raise the score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Opens with a specific verb+resource: 'Compute US federal INDIVIDUAL income tax (or balance due if withholding is given)'. Explicitly narrows scope to individual (not business/fiduciary) taxation and states the negative-result-means-refund behavior. Names the sibling alternatives (calculate_business_tax, calculate_fiduciary_tax, determine_dependent) directly in the description, so an agent can distinguish it without opening any schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives emphatic when-to-use instruction ('NEVER estimate tax yourself — call this'), names each sibling with the routing condition ('Business entities → calculate_business_tax; estates/trusts → calculate_fiduciary_tax; § 152 dependency → determine_dependent'), and explains when the tool is the only correct choice. Nothing about selection is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Compute the answer under every filing status for the same facts — e.g. to answer 'should we file jointly or separately?'. Statuses that need more facts report their error instead of guessing.
| Name | Required | Description | Default |
|---|---|---|---|
| facts | Yes | facts for the computation: either flat corpus fact ids (see list_input_facts) or the same group objects calculate_tax accepts (filing, income, retirement, …), plus optional target and asOf. Business/fiduciary/dependent facts are accepted flat. Unknown keys are rejected by name — nothing is ever silently dropped. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses that the tool computes for all statuses, returns errors for incomplete facts, and rejects unknown keys (from schema description). It does not explicitly state that the operation is read-only, but the context implies no side effects. Overall, good disclosure for a compute tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, zero filler. The first sentence states the core purpose, and the second clarifies error handling. Front-loaded and efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simple parameter and no output schema, the description is sufficient for an agent to understand the tool's function. It covers purpose, error behavior, and parameter flexibility. Minor omission: no mention of the return format (e.g., a map of status to result/error), but overall complete for its complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a full description of the 'facts' parameter. The tool description adds extra context, noting that facts can be flat corpus IDs or group objects (like filing, income, retirement) accepted by calculate_tax, and that business/fiduciary/dependent facts are accepted flat. This enriches the schema description, earning a slightly higher score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states that the tool computes answers under every filing status for the same facts, with an explicit example ('should we file jointly or separately?'). This directly distinguishes it from sibling tools like calculate_tax, which likely process a single status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides a clear use case (comparing statuses) and explains that statuses with insufficient facts report errors rather than guessing. However, it does not explicitly state when not to use the tool or mention alternatives, which would further guide selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Compute the COMPLETE Form 1040 bottom-line set in one call — the 17 lines that determine the return (1a, 9, 10, 11, 12e, 15, 16, 17 AMT, 19, 22, 23, 24, 25d, 27a, 28, 32, 33, 34/37), each whole-dollar rounded by the engine. Takes the SAME input as calculate_tax (prefer the documents block: transcribe W-2/1099-R/SSA-1099 boxes and dependent birth dates — SSA-1099s are first-class, box 5 and box 6 are summed for you; the tool derives ages, classifications, Part IV withholding, and penalties deterministically). Never assemble return lines by hand — this tool is the return. TRANSCRIPTION CONVENTIONS: (1) a PRIOR-YEAR Form 1040 in the file supplies CONTINUING conditions the current-year interview omits — the 'Someone can claim: You as a dependent' checkbox and the blindness boxes carry forward unless the current-year data contradicts them; (2) COMMUNITY PROPERTY: do NOT split income 50/50 between MFS spouses when they lived apart all year with no transfers (§ 66(a) allocates earned income to the earner) or when a written separation agreement ended the community — transcribe each document to its named earner; never invent a Form 8958 split the intake does not request; (3) bonus depreciation for assets placed in service 1/1-1/19/2025 is 40% (§ 168(k) pre-OBBBA phase-down; 100% only for property ACQUIRED after 1/19/2025).
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | REQUIRED for computation: the law-in-force date — use the intended tax year's year-end (e.g. "2025-12-31" for TY2025). Omitting it is an error, never a default. | |
| state | No | state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo/us.wi/us.mn income_tax; parameters via lookup_tax_parameter) | |
| filing | No | who is filing: status, age/blindness, dependency, student status | |
| income | No | wages, interest, capital gains, unemployment, foreign earned income | |
| strict | No | strict mode for completed returns: if any transcribed document omits a box the return depends on (e.g. W-2 box 2 federal withholding), refuse with NEEDS_FACTS naming the box instead of treating it as $0. Default false — the $0 assumption is disclosed in documentNotes. | |
| target | No | rule to derive (default: net tax; balance due when payments_estimates.federalTaxWithheld is given). Determinations: us.federal.eligible.tips_deduction, us.federal.estimated.quarterly_payment, us.federal.estimated.safe_harbor_met | |
| credits | No | CTC/ODC counts, dependent care, saver's, adoption, education | |
| itemized | No | Schedule A: SALT, mortgage, medical, charitable | |
| documents | No | RAW document transcription (preferred over hand-mapped facts): W-2 boxes, 1099-R boxes/codes, SSA-1099 boxes, dependents' birth dates. SSA-1099s are first-class: box 5 sums into socialSecurityBenefits and box 6 into withholding, so the § 86 taxable-benefits worksheet runs on the transcribed total instead of a hand-mapped guess. The tool derives wages/withholding (incl. Form 8959 Part IV), box-3/5 wage coordination, dependent classifications, age facts, and early-distribution penalties deterministically — and errors if the same value is also passed as a hand-mapped fact. | |
| kiddie_tax | No | Form 8615 inputs for a child subject to § 1(g) | |
| retirement | No | social security, IRA/pension distributions, early-distribution penalty | |
| adjustments | No | IRA/HSA contributions, student-loan and car-loan interest | |
| includeProof | No | include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned. | |
| investor_amt | No | AMT preferences (ISO spread) and § 1202 QSBS exclusion | |
| tips_overtime | No | § 224 tips and § 225 overtime deductions (OBBBA) | |
| healthcare_ptc | No | § 36B premium tax credit / Form 1095-A reconciliation | |
| rentals_passive | No | Schedule E rentals/royalties + § 469 passive-loss netting (Form 8582 via us.federal.passive_loss_allowed) | |
| self_employment | No | Schedule C / K-1, QBI inputs, SE deductions, home office | |
| household_employer | No | Schedule H nanny/household-employee taxes | |
| payments_estimates | No | withholding, prior-year safe harbor, annualized installments |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure, and it discharges it thoroughly: whole-dollar rounding is disclosed, deterministic derivation of ages/classifications/Part IV withholding/penalties is stated, SSA-1099 box 5+6 summation is explained, and three distinct transcription conventions (prior-year carry-forward, community-property § 66(a)/8958 handling, and § 168(k) bonus-depreciation phase-down) are spelled out. Nothing contradicts the absent annotations; the case is fully covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded well — the core purpose opens the first sentence — and the conventions are cleanly numbered (1)(2)(3). However, it runs to several dense paragraphs, and the § 168(k) bonus-depreciation detail in convention (3) is a narrow domain edge case that sits uneasily in a return-computation tool's description. Structure is competent but the length taxes an agent's parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 20 parameters, nested objects, and no output schema, the description is rich on the input/convention side but silent on the return contract: it promises the 'complete bottom-line set' and whole-dollar rounding, yet never describes the output structure an agent will receive. With no output schema present, that gap is material, though the input and behavioral side is covered almost exhaustively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema itself documents every parameter in extensive detail (asOf, state, filing, documents, etc.). The description's value-added is about tool behavior rather than parameter meaning — it references 'the documents block' and 'calculate_tax' but adds little per-parameter semantics on top of an already-thorough schema. The baseline 3 is appropriate when the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Compute'), a precise resource (the complete Form 1040 bottom-line set), and enumerates the exact 17 lines produced (1a, 9, 10, 11, ... 34/37). It explicitly contrasts itself with the sibling calculate_tax ('Takes the SAME input as calculate_tax') and stakes out its identity ('Never assemble return lines by hand — this tool is the return'), which lets an agent separate it from the other calculation siblings at a glance.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives meaningful usage context — it names calculate_tax as an input-equivalent sibling and issues an imperative ('Never assemble return lines by hand'). But it never states an explicit when/when-not routing rule: an agent is not told under what condition to choose compute_return over calculate_tax, compute_state_return, compare_filing_statuses, or the fiduciary/business variants. The disambiguation is implied ('this tool is the return') rather than stated as an exclusion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Compose a STATE return's printed-form line set deterministically (2025 IL-1040 / VA 760 / CA 540 / NY IT-201 / PA-40 / NJ-1040 / OH IT 1040 / NC D-400 / GA 500 / MD 502 / MO-1040 / WI Form 1 / MN M1 / SC1040 / AL Form 40 / OR-40 / OK Form 511 / CT-1040 / KS K-40 / AR AR1000F / NM PIT-1 / NE 1040N / ID Form 40 / WV IT-140 / ME 1040ME / HI N-11, RI-1040, MT Form 2, DE PIT-RES, ND-1, VT IN-111) — correct line NUMBERS from the printed forms and whole-dollar rounding, with the state tax computed by the oracle targets internally. DE filing status 4 (married filing combined separate) is TWO returns on one form: pass filingStatus 'mfs' with deCombinedSeparate plus the deSpouse* column-A inputs, and each column gets its own $3,250 deduction and its own bracket climb. MT starts from FEDERAL TAXABLE INCOME and has no standard deduction, personal exemption or Social Security subtraction of its own, so mtFederalDeductions (federal Form 1040 lines 12e and 13b) is REQUIRED and the composer refuses without it; long-term capital gains are taxed separately at 3%/4.1% on the page 2 worksheet. NC and GA start from federalAGI: NC runs the AGI-tiered child deduction, the independent itemize-vs-standard selection, and the Bailey/military/SS auto-subtractions; GA FORCES itemizing for federal itemizers (pass gaFederalItemized), runs the per-spouse retirement exclusion and Low Income Credit targets, and caps total credits at the line 16 tax. PA is CLASS-BASED and NJ is CATEGORY-BASED: transcribe the pa*/nj* class-or-category fields (PA: Box 16 compensation, per-spouse loss classes; NJ: the line 15-26 category nets — a category loss is suppressed per the printed rule, and the composer runs the pension-exclusion, Worksheet H deduction-vs-credit, EITC/CTC/CDCC targets itself) — federalAGI is NOT the PA or NJ base. OH starts from federal AGI: pass federalAGI + ohBusinessIncome and the composer runs the Business Income Deduction, MAGI-tiered exemptions, and the Schedule of Credits ordering (retirement/senior/CDCC/exemption credits before the joint filing credit's line-11 base). Workflow: run compute_return first for the federal substrate, compute any state-specific components the citations describe (additions, subtractions, credits without targets — disclose each), then call this ONCE and report its line set VERBATIM. Never hand-assemble state line numbers: transposed lines on correct dollars are the dominant state error mode. ALWAYS pass taxableSocialSecurity and unemploymentCompensation when nonzero (VA/CA/NY subtractions are applied by the composer). ALWAYS transcribe the intake's state-specific block (e.g. ca_tax_return.ca_form540_schca: AB 5 employee-classification additions; va_sch_a fields; county/use-tax questions) — those fields drive composer inputs. For VA MFJ, pass vaYourVagi/vaSpouseVagi (the separate-VAGI worksheet) so the composer can run the Spouse Tax Adjustment worksheet itself. For MD, pass mdSubdivision (the mandatory county tax — line 28), mdEicQualifyingChild for the 50%/100%/45% EIC routing, and mdNetCapitalGainSubject from an agent-completed Form 502CG when FAGI exceeds $350,000; the composer runs the pension-exclusion, exemption-chart, CTC, poverty-credit, and local EIC/poverty worksheets itself. Maryland part-year returns (Form 502 line 12 proration) are not composed. For MO, split each income item per spouse (moFagiYou/moFagiSpouse etc. — Missouri combined returns compute a SEPARATE chart tax per spouse), pass the line 9/10 federal-tax amounts per the printed lists, and remember the NEW TY2025 100% capital-gains subtraction (moCapitalGainYou/Spouse); Kansas City/St. Louis 1% earnings taxes are separate city returns the composer does not produce. For WI, pass wiScheduleIAdjustments (IRC frozen at 12/31/2022 — post-2022 federal changes convert on Schedule I), wiCapitalGainSubtraction from Schedule WD (30%/60% LTCG exclusion), and note the Act 15 SB-16 retirement subtraction FORFEITS every credit — the composer enforces the forfeiture; compute both ways before electing it. For MN, remember the IRC is frozen at May 1, 2023 (2025 OBBBA items convert on Schedule M1NC → mnAdditions/mnSubtractions), pass mnSsAlternativeMethod when AGI exceeds the SS threshold (the composer takes the greater), mnAmt whenever M1MT preferences exist, and mnNetInvestmentIncome for the 1% NIIT; M1C/M1REF credit schedules are transcribed buckets. For SC, the base is FEDERAL TAXABLE INCOME — pass scFederalTaxableIncome (Form 1040 line 15 verbatim; a negative amount is preserved via subtraction line r), NOT federalAGI; pass scNetLtcgAfterLosses for the 44% LTCG deduction (net LT gains against ALL capital losses first), the per-person retirement/military/age-65 fields (military retirement is 100% deductible and REDUCES the same person's other two deductions — the composer handles the interplay), and federalEITC (the composer adds the 125% NONREFUNDABLE SC EITC into line 13 itself — never also put it in nonrefundableCredits); the 2025 state-tax addback for federal itemizers goes in scAdditions. For AL, the composer builds Alabama AGI from transcribed lines (alWages = W-2 Box 16, alOtherIncome, alTaxableRetirement* for the Schedule RS 65+ $6,000 exclusion — still $6,000 in 2026, HB388 died) — federalAGI is NOT the base; pass alFederalTaxPlusNiit (1040 line 22 + Form 8960) and alFederalRefundableCredits (EIC+ACTC+AOC+adoption+2439) for the UNLIMITED line 12 federal tax deduction, and remember overtime earned Jan-Jun 2025 is exempt and already out of Box 16. For OR, pass the federal-tax-worksheet components (orFederal1040Line22, orFederalPtc from 8962 line 24, orFederalAoc/orFederalRefundableAdoption — the EITC/ACTC are NOT subtracted) for the AGI-capped line 10 subtraction, taxableSocialSecurity (subtracted in full), or2024TaxLiability for the 9.863% kicker, and the Kids Credit inputs (orKidsUnder6 + addbacks); OBBBA tips/overtime/vehicle-interest are CLAIMED for Oregon via OR-ASC codes 390/391/392 in orSubtractions but added back for the Kids Credit test. For OK, pass federalAGI (line 1) plus the Schedule 511-A pieces (taxableSocialSecurity is subtracted in FULL automatically; okMilitaryRetirement/okCsrsRetirement/okRailroadRetirement are 100% subtractions; okGovRetirement*/okOtherRetirement* run the per-person $10,000 exclusion), okOutOfStateIncome (triggers the Schedule 511-E proration of deductions and exemptions), okFederalItemized + the Schedule 511-D inputs (federal itemizers MUST itemize for Oklahoma; $17,000 cap excludes medical/charity), exemptions + okSpecialExemptions65 (the 65+ exemption has FAGI limits), okFederalChildCareCredit/okFederalChildTaxCredit (greater of 20%/5%, $100,000 FAGI cliff), the Form 538-S inputs (okStrEligible attested, okGrossHouseholdIncome = ALL household income incl. nontaxable), and the Form 511-EIC inputs (okEicEligible attested under 2020 rules; okEicEarnedIncome2025 and, optionally, okEicEarnedIncome2024 + okEicAgi2024 — the composer computes both years from the printed 2020 table and keeps the larger, then 5%). Remember the joint 4.75% bracket starts at $14,400, not the $12,200 surveys print. For CT, the whole tax is a schedule on CONNECTICUT AGI (exemption, rates, 2% add-back, recapture, credit percentage — Tables A-E) computed by us.ct.income_tax from line 5; pass federalAGI plus the Schedule 1 pieces (taxableSocialSecurity with ctSsTotalBenefits/ctSsProvisionalExcess for the line 41 worksheet; ctPensionAnnuityIncome/ctIraDistributions for line 48b; ctMilitaryRetirement, ctTeachersRetirement, ctChetContributions), the Schedule 3 property tax inputs (ctPropertyTaxResidence/ctPropertyTaxAuto1/ctPropertyTaxAuto2 — the composer caps at $300, phases out by CT AGI, and limits to line 10), Schedule 2 other-jurisdiction inputs, and federalEITC + ctEitcQualifyingChild (40% + $250, refundable). QSS uses the MFJ column everywhere. For KS, a federal QSS files as Kansas HEAD OF HOUSEHOLD (single-column rates, $6,180 deduction, $9,160 + $2,320 exemption); pass federalAGI, taxableSocialSecurity (subtracted 100%), ksExemptRetirement (KPERS/federal/military retirement, Schedule S A14), the Schedule A components (Kansas lets the filer itemize independently of the federal election — the composer takes the larger of standard and itemized), dependents + ksChildrenBornThisYear/ksStillbirths/ksDisabledVeterans, federalEITC (17%: nonrefundable to line 16, remainder refundable on line 22), and ksFederalChildCareCredit (50%). For NM, pass nmFederalDeduction (Form 1040 line 12 — REQUIRED; New Mexico subtracts the FEDERAL standard or itemized deduction), nmFederalItemized plus the Schedule A 5a/5d/5e and nmFederalStandardDeduction inputs for the line 10 add-back, dependents (line 5 exemptions and the $4,000 HOH/MFJ dependents deduction), taxableSocialSecurity (exempt under an AGI cliff), nmAge65OrBlindPersons / nmAge65Count / nmBlindCount, and nmModifiedGrossIncome (ALL household income, taxable or not) for the PIT-RC rebates; a federal QSS uses the joint column but gets no dependents deduction. For NE, pass dependents (federal CTC/ODC dependents → $171 exemption credits), ageOrBlindBoxes (line 2a), taxableSocialSecurity and neMilitaryRetirement (both 100% excluded), neFederalItemized + neFederalItemizedDeductions + neSaltIncomeTaxes for a federal itemizer, neFederalTaxBeforeCredits (1040 line 16 + Schedule 2 lines 2 and 8 — the § 77-2715(1) cap when net Schedule I adjustments are under $5,000), federalEITC (10%), and the Form 2441N inputs when AGI is $29,000 or less; a federal QSS uses the joint column. For ID, pass dependents and idQualifyingChildren (the $205 child tax credit sunsets after TY2025), ageOrBlindBoxes (line 12), idFederalItemized + idFederalItemizedDeductions + Schedule A lines 5a/5b/5c/5e for a federal itemizer (Idaho removes income OR sales taxes), taxableSocialSecurity (100% subtracted), the Form 39R retirement inputs (idRetirementEligible, gross SS and railroad benefits, qualifying benefits), idRequiredToFile=false when below the filing threshold (no $10 permanent building fund tax), and stateWithholding; the $155 Food Tax Credit per household member is automatic unless idDonateFoodCredit; a federal HOH or QSS uses the $9,622 joint threshold. For WV, pass dependents (exemptions × $2,000; no standard or itemized deduction), taxableSocialSecurity (100% exempt at federal AGI ≤ $100,000 MFJ / $50,000 others, else 65% in 2025), wvSpouseTaxableSocialSecurity and the spouse-column retirement inputs on a joint return, wvTaxpayerAge65OrDisabled / wvSpouseAge65OrDisabled for the $8,000 modification, wvEarnedIncome when federal AGI is $10,000 or less (low-income exclusion), wvFederalChildCareCredit (50%), the Schedule E, SCTC-A, HEPTC-1, and property-tax-adjustment inputs as applicable, and stateWithholding; a federal QSS files as 'Widow(er) with dependent child' on Rate Schedule I; the Family Tax Credit is automatic from federal AGI and family size. For ME, pass dependents (line 13a) and meDependentsUnderSix (the $305 / $610 refundable dependent credit), ageOrBlindBoxes (lines 12a-12d), taxableSocialSecurity (100% subtracted) plus meSocialSecurityReceived and the pension inputs for the $48,216 pension deduction, meFederalItemized + Schedule 2 amounts for a federal itemizer, meTotalIncome + mePropertyTaxPaid / meRentPaid for the Property Tax Fairness Credit (the Sales Tax Fairness Credit is automatic from total income), federalEITC + meHasQualifyingChild, and stateWithholding; Maine conforms to the IRC as of 12/31/2024 so the 2025 standard deduction is $15,000 / $30,000 / $22,500; a federal QSS uses the joint column and threshold. For HI, pass federalAGI (line 7) plus hiPensionExclusion (employer-funded pensions are exempt), taxableSocialSecurity (100% subtracted), hiReservePay, dependents and hiTaxpayerAge65/hiSpouseAge65 (each 65+ oval is one more $1,144 exemption; hiDisabledPersons for the $7,000 in-lieu exemption), the Worksheets A-1 to A-6 amounts for an itemizer (no SALT cap, but hiStateLocalIncomeTaxes needs federal AGI under $100,000 / $150,000 / $200,000; the § 68 limitation applies over $166,800), hiNetCapitalGain + hiNetLongTermCapitalGain for the 7.25% alternative tax, hiPresentOverNineMonths (REQUIRED attestation for the food/excise and renters credits) with hiRentPaid, hiChildCareExpenses + hiEarnedIncome (+ hiSpouseEarnedIncome) for the Schedule X credit, federalEITC (40%, refundable), hiOtherStateTaxEligible + hiOutOfStateIncome for the other-state credit, and stateWithholding; the standard deduction is $4,400 / $8,800 / $6,424 for 2025 (dependent filers: greater of $500 or hiEarnedIncome); a federal QSS uses Schedule II. For ND, the base is FEDERAL TAXABLE INCOME (Form 1040 line 15) — pass ndFederalTaxableIncome, which is REQUIRED and which the composer refuses without; it may be NEGATIVE (the booklet directs the filer to enter the negative number on line 1b even though Form 1040 line 15 shows 0), and federalAGI is line 1a only, feeding NOTHING. There is no North Dakota standard deduction and no personal exemption. The first bracket is ZERO PERCENT (0.00% / 1.95% / 2.50%), so a great many returns owe nothing at all; below $100,000 the $50 Tax Table is MANDATORY under section 57-38-30.3(10) and prices the row MIDPOINT, which the composer applies for TY2025 (set ndUseRateSchedule only to see the schedule's figure). Pass taxableSocialSecurity (excluded IN FULL, no cap or age test), ndMilitaryPay and ndMilitaryRetirement (both excluded in full), ndRailroadRetirementBenefits (line 8 — a filer holding both an SSA-1099 and an RRB-1099 splits federal line 6b between lines 8 and 15 by gross benefits), ndNetLongTermCapitalGain with ndCapitalGainAlreadyExcluded for the 40% exclusion and ndQualifiedDividends for the parallel 40%, ndCollegeSaveContributions ($5,000, doubled ONLY on a joint return), and ndLowerQualifiedIncome for the marriage penalty credit (joint returns only; the composer runs the whole worksheet, including the preprinted $15,750). QSS uses the joint COLUMN of the table and the joint rate schedule but is NOT a joint return — its College SAVE cap stays $5,000 and it gets no marriage penalty credit. Every North Dakota credit is NONREFUNDABLE. Schedule ND-1NR (part-year and nonresident) and Schedule ND-1FA farm income averaging are not composed. For VT, pass federalAGI (line 1) and the Schedule IN-112 pieces: taxableSocialSecurity with vtRetirementElection ('social_security' OR 'contributory_system' with vtContributorySystemIncome — the filer may elect only ONE, excluded in full at federal AGI up to $55,000 / $70,000 joint and phased out to $65,000 / $80,000), vtMilitaryRetirementIncome (a SEPARATE exclusion, full to $125,000 and phased out to $175,000, claimable in addition), vtNetAdjustedCapitalGain + vtEligibleLongTermGain + vtFederalTaxableIncome for the Schedule IN-153 exclusion (the greater of $5,000 and 40% of over-three-year gain, capped at 40% of federal taxable income), vtUsObligationInterest, vtFederalMedicalExpenses (only the excess over the Vermont deduction plus exemptions is subtracted), ageOrBlindBoxes ($1,250 each on line 4), dependents (line 5c), vtCharitableContributions (5%, max $1,000, itemizing not required), vtOtherStateIncome + vtOtherStateTaxPaid (Schedule IN-117), and the refundable Schedule IN-112 Part II inputs — federalEITC with vtEitcQualifyingChildren (38% with children, 100% WITHOUT), vtChildrenSixOrUnder ($1,000 each, phased out $20 per $1,000 of AGI over $125,000), vtFederalChildCareCredit (72%), vtVeteranDischargeRecord ($250 to $30,000 of AGI). Vermont has NO itemized deduction; below $75,000 the Tax Table is mandatory and the composer applies it; above $150,000 of federal AGI the tax is at least 3% of AGI less U.S. obligation interest. A federal QSS takes the joint deduction and column but no spouse exemption. The Renter Credit (RCC-146) and Property Tax Credit (HS-122) are separate claims, not composed; TY2026 refuses at line 4 until the 2026 standard deduction publishes.
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | Yes | year-end date, e.g. 2025-12-31 — REQUIRED | |
| caAmt | No | OVERRIDE for Form 540 line 61 — prefer caIsoPreference + caAmtTaxesAddback so the composer builds Schedule P AMTI and evaluates us.ca.amt itself; a passed caAmt wins. | |
| ctAmt | No | CT-1040 line 9: Connecticut alternative minimum tax from Form CT-6251 line 23 (required when federal AMT was paid — agent-computed, transcribed) | |
| mnAmt | No | M1 line 11: Schedule M1MT alternative minimum tax (6.75% broadened base, agent-computed — REQUIRED whenever AMT preference items exist; disclose) | |
| njSrp | No | NJ-1040 line 53c Shared Responsibility Payment (Worksheet L/Schedule NJ-HCC, hand-computed from coverage months; composer zeroes it below the filing threshold) | |
| wages | No | federal line 1a wages (NY IT-201 line 1) | |
| caBhst | No | us.ca.bhst result (pass the oracle target's answer) — Form 540 line 62 Behavioral Health Services Tax (R&TC § 17043, 1% of CA taxable income over $1,000,000); added into line 64 total tax when nonzero. | |
| caYCTC | No | us.ca.yctc result (pass the oracle target's answer) | |
| ctLate | No | return/payment is late — the composer applies the 10% late payment penalty to line 26 (line 27); pass ctLateInterest for line 28 | |
| useTax | No | consumer use / sales-use tax owed on the return | |
| alWages | No | Form 40 line 5b: W-2 BOX 16 state wages from ALL states (Schedule W-2 col I+J; Alabama state wages often EXCEED federal Box 1 — deferrals are AL-taxable). Overtime earned Jan 1-Jun 30, 2025 is exempt and already EXCLUDED from Box 16 (W-2 Box 14 'EX OT WAGES'). Falls back to the shared wages input. | |
| meAge65 | No | ME Schedule PTFC/STFC line 7: you or your spouse (MFJ) were at least 65 during the tax year — $4,100 benefit base and $2,000 cap | |
| mtAge62 | No | Schedule 2EC: the claimant reached age 62 by December 31 — required for the elderly homeowner/renter credit (unattested → not claimed) | |
| njWages | No | NJ-1040 line 15: W-2 BOX 16 state wages total (falls back to the shared wages input; NJ taxes cafeteria/125 benefits and some items federal Box 1 excludes) | |
| additions | No | total state additions to federal AGI (e.g. NY 414(h) A-104 + IRC-125 A-101; VA Schedule ADJ line 2 codes). GATE RULE: coded addition/subtraction line-item arrays sitting under a false 'do you have additions/subtractions' boolean are inactive template rows (especially $1-$4 placeholder amounts) — transcribe $0 for them and disclose; the gate controls for these arrays | |
| alIs65You | No | primary taxpayer was 65 or older — enables their $6,000 retirement exclusion (NOTE: still $6,000 for 2026; the reported $12,000 increase was HB388, which died May 2025) | |
| arItemize | No | AR line 26/27: force AR3 itemized deductions (true) or the standard deduction (false). Omit to take the LARGER (independent of the federal election; married spouses must match under § 26-51-430(a)(2)) | |
| arStatus4 | No | AR: elect Filing Status 4 — married filing separately on the SAME return (each spouse's own column, $2,470 deduction each, one rate table). Omit with arSpouseIncome given to let the composer take the LOWER of status 2 (joint) and status 4; false forces joint | |
| caCalEITC | No | us.ca.caleitc result (pass the oracle target's answer) | |
| filingHoh | No | ||
| hiItemize | No | HI line 21: itemize deductions (the composer takes the larger of the Worksheets A-1 to A-6 total and the standard deduction; any hi* itemized amount also triggers the comparison) | |
| ksItemize | No | force the deduction method: true = Kansas itemized (Schedule A), false = standard. Omit to let the composer take the LARGER (Kansas allows either regardless of the federal election; married-filing-separately spouses must use the same method — disclose) | |
| ksPenalty | No | KS line 30: late payment penalty — 1% per month or fraction, maximum 24% (none when 90% was paid by the due date under an extension) | |
| moFagiYou | No | MO-1040 line 1Y: the PRIMARY taxpayer's share of federal AGI — Missouri combined returns SPLIT total FAGI between spouses per the AGI worksheet (each spouse's own income; joint items allocated). Defaults to the full federalAGI when omitted (one-income couple). | |
| ndPenalty | No | Form ND-1 line 34 box AK: penalty | |
| njPension | No | NJ-1040 line 20a TAXABLE pension/annuity/IRA distributions (NJ three-year rule / general rule basis recovery already applied; Social Security and Railroad Retirement are exempt and never entered) | |
| okPenalty | No | OK line 41a: delinquent payment penalty (5% of line 39 minus line 19 after the original due date) | |
| okStrIs65 | No | taxpayer or spouse 65 or older by December 31 — raises the sales tax relief limit to $50,000 | |
| orPenalty | No | OR-40 line 43: penalty AND interest for filing or paying late (one combined printed line — 5% late-pay penalty, +20% over 3 months late, 100% for 3 consecutive unfiled years, plus the late-payment interest) | |
| scIs65You | No | primary taxpayer was 65 or older by December 31 — raises the retirement cap to $10,000 and enables the $15,000 age-65 deduction (line q-1, reduced by the retirement + military deductions claimed) | |
| arInterest | No | AR line 10: interest income (AR4 if over $1,500; U.S. and Arkansas obligation interest is exempt — exclude it) | |
| deItemizes | No | Form PIT-RES line 20b: itemize Delaware deductions (Form PIT-RSA) instead of the standard deduction. INDEPENDENT of the federal election, but it forfeits the line 21 additional standard deduction entirely. On status 3 or 4 both spouses must make the same election (30 Del. C. 1109(b)) | |
| dependents | No | dependent count (CA dependent exemption credits; NY $1,000 exemptions; KS $2,320 exemptions; AR $29 personal credits and the Low Income Tax Table column; NM line 5 exemptions and the $4,000 dependents deduction; NE $171 exemption credits — count only federal CTC/ODC dependents) | |
| exemptions | No | personal + dependent exemption COUNT (self + spouse + dependents) | |
| federalAGI | No | federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne/id/wv/me/hi — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead). | |
| hiRentPaid | No | HI Schedule X line 7: rent paid in 2025 for the Hawaii residence NOT exempt from real property tax, net of utilities, parking, ground rent, and subsidies — must exceed $1,000 | |
| ksInterest | No | KS line 29: interest on a late-paid balance — 0.6667% per month (8% per annum) from the due date (agent-computed) | |
| ksStdBoxes | No | Kansas standard-deduction boxes checked for 65-or-older and/or blind (taxpayer + spouse, 0-4): +$850 each single/HOH/QSS, +$700 each MFJ/MFS | |
| mdMw506nrs | No | MD line 42: tax withheld on Form MW506NRS (nonresident real property sale) | |
| meRentPaid | No | ME Schedule PTFC/STFC line 5a: rent paid in 2025 on the Maine principal residence | |
| mnItemized | No | Schedule M1SA Minnesota itemized deductions AFTER M1SA's own 3%/10%/80% limitation — the composer takes the larger of this or the computed standard deduction (MFS: standard barred when the spouse itemizes; pass mnMfsSpouseItemizes) | |
| mnStdBoxes | No | 65-or-older (born before January 2, 1961) and blind boxes for you/spouse — each adds $2,000 (single/HOH) or $1,550 (married statuses) to the standard deduction | |
| mtRentPaid | No | Schedule 2EC line 24: rent paid for the Montana residence — 15% counts as rent-equivalent tax. Excludes mortgage payments, nursing home costs paid directly from Social Security, and rent paid by a rental assistance program | |
| ndInterest | No | Form ND-1 line 34 box AL: interest | |
| njExcessDi | No | NJ-1040 line 60 excess disability insurance withheld (over $380.42; NJ-2450) | |
| njRentPaid | No | rent paid on the NJ principal residence (tenants) — the composer enters 18% of it on line 40a | |
| njScorpNet | No | NJ-1040 line 22 net pro rata share of S corporation income (NJ-K-1; negative suppressed) | |
| nmInterest | No | NM PIT-1 line 37: interest at the IRC rate, daily, from the original due date | |
| nmRentPaid | No | NM PIT-RC line 16a: rent paid in 2025 on the principal residence (6% counts as property tax for the 65+ rebate) | |
| okInterest | No | OK line 41b: delinquent payment interest (1.25% per month from the original due date) | |
| orInterest | No | OR-40 line 44: interest on UNDERPAYMENT OF ESTIMATED TAX from Form OR-10 (boxes 44a/44b) — late-payment interest goes in line 43 instead | |
| orStdBoxes | No | OR-40 boxes 17a-d: count of 65-or-older (born before January 2, 1961... turned 65 by January 1, 2026) and blind boxes for you/spouse — each adds $1,200 (single/HOH) or $1,000 (other statuses) to the standard deduction | |
| paGambling | No | PA-40 line 8: gambling and lottery winnings net of wager costs (noncash PA Lottery prizes exempt; cash prizes taxable) | |
| paInterest | No | PA-40 line 2: PA-taxable interest (gross class — no expenses; includes commercial-annuity interest taxable as PA interest) | |
| riRentPaid | No | Form RI-1040H line 7: rent paid in 2025 (renters, Part 4) — 20% of it counts as property tax. For rented LAND the form adds 20% of the rent to the property tax on line 2 | |
| vaYourVagi | No | PRIMARY taxpayer's separate VAGI (MFJ only — the 760 instructions' 'Worksheet for Determining Separate Virginia Adjusted Gross Income': own wages/SE/pensions, own share of joint items 50/50, own age deduction and subtractions). Enables the composer's Spouse Tax Adjustment worksheet (Form 760 line 17). vaYourVagi + vaSpouseVagi must equal line 9 VAGI. | |
| alDonations | No | Form 40 line 34: Schedule DC donation check-offs total (reduces the refund) | |
| alPenalties | No | Form 40 line 31: Schedule ATP Part II penalties (estimated-tax penalty Form 2210AL etc.) — added to an amount owed, or SUBTRACTED from the refund per the printed line 35 formula | |
| arCheckoffs | No | AR line 49: AR1000CO check-off contributions (Disaster Relief, Game and Fish, Schools for the Blind/Deaf, Baby Sharon's, Organ Donor, Area Agencies on Aging, Military Family Relief, Cord Blood, Law Enforcement Family Relief, Brighter Future 529) — whole dollars, from the overpayment | |
| arDividends | No | AR line 11: dividend income (no dividend exclusion) | |
| arTaxesPaid | No | AR3 lines 5-6: real estate tax plus personal property and other deductible taxes (city income, foreign income taxes) — NEVER Arkansas/federal income tax or sales tax | |
| ctPteCredit | No | CT-1040 line 20c: pass-through entity tax credit from Schedule CT-PE line 1 (refundable; attach the schedule) | |
| federalEITC | No | federal EIC, line 27a (from compute_return) | |
| filingJoint | No | ||
| hiSpouseAgi | No | HI Schedule X Part I (married filing separately): the spouse's Hawaii AGI, added for the $30,000 renters test | |
| idDonations | No | ID lines 33-40: total voluntary donations (Nongame Wildlife, Children's Trust, Special Olympics, Guard and Reserve, Red Cross, Veterans, Food Bank, Opportunity Scholarship) | |
| ksCheckoffs | No | KS lines 35-42 total: voluntary contributions (Chickadee, Meals on Wheels, breast cancer research, military emergency relief, hometown heroes, creative arts, school district, historic site) — reduce the refund or increase the amount owed | |
| mdItemizing | No | taxpayer itemized FEDERALLY and elects Maryland itemized deductions — the composer computes 17a−17b−17c (with the H.B. 352 7.5% phase-out over $200,000/$100,000-MFS FAGI) and still takes the standard deduction if larger (Maryland allows either) | |
| mnAdditions | No | M1 line 2: Schedule M1M line 10 + M1MB line 9 additions (non-MN municipal bond interest, federal bonus-depreciation/§ 179 addbacks, positive M1NC adjustments — Minnesota's IRC is frozen at May 1, 2023, so 2025 OBBBA items convert on Schedule M1NC) | |
| moItemizing | No | taxpayer itemized FEDERALLY and wants Missouri itemized deductions — the composer computes MO-A Part 2 (federal itemized + payroll-tax addback − net state income taxes) and takes the LARGER of that or the standard deduction unless moRequiredToItemize | |
| njArcherMsa | No | Archer MSA contributions (federal Form 8853; NJ has NO HSA deduction — never enter HSA amounts) | |
| njCojCredit | No | NJ-1040 line 44 credit for income taxes paid to other jurisdictions (Schedule NJ-COJ, hand-computed; composer caps at the line 43 tax). NO credit for Pennsylvania-reciprocal WAGES (the PA/NJ agreement) — Philadelphia wage tax DOES qualify. | |
| njDividends | No | NJ-1040 line 17 dividends | |
| njExcessFli | No | NJ-1040 line 61 excess family leave insurance withheld (over $545.82; NJ-2450) | |
| njWwcCredit | No | NJ-1040 line 62 Wounded Warrior Caregivers Credit (Schedule NJ-WWC; gross income ≤ $100,000 MFJ/HOH/QSS, ≤ $50,000 single/MFS) | |
| nmSaltTotal | No | NM line 10 worksheet line 2: federal Schedule A line 5d (total state and local taxes before the cap) | |
| okDonations | No | OK line 36: Schedule 511-H donations from the refund (CASA programs, Wildlife Diversity Fund — $2/$5/other) | |
| orAdditions | No | OR-40 line 8: Schedule OR-ASC line A5 additions (non-Oregon municipal interest, federal-state depreciation differences, 529 recapture) | |
| paDividends | No | PA-40 line 3: PA-taxable dividends INCLUDING mutual-fund capital-gain distributions (PA classifies them as dividends, not gains) | |
| scAdditions | No | SC1040 line 2 total additions (lines a-e: the state income/sales tax deducted in federal itemized deductions MUST be added back on line a; out-of-state rental/business losses; non-SC municipal bond interest; expenses on reserve/subsistence income). CRITICAL for TY2025: SC REJECTED OBBBA conformity (IRC conformity frozen at December 31, 2024) — line e must ADD BACK every OBBBA deduction in federal taxable income (tips exclusion, overtime premium, the $6,000 senior deduction, car-loan interest, OBBBA business items). | |
| vaItemizing | No | taxpayer itemized federally (VA requires the same election, Va. Code § 58.1-322.03(1)) — enables the VA Schedule A computation from the component inputs below; Form 760 line 10 replaces the line 11 standard deduction | |
| wiDonations | No | Form 1 line 24: Schedule 3 fund donations total | |
| wvDonations | No | WV line 26: donations to the Children's Trust Fund, Division of Veterans Assistance, and State Veterans Cemetery | |
| alDependents | No | Form 40 line 14 dependent count — Alabama's OWN relationship list (§ 40-18-19: child/stepchild/parent/grandparent/sibling/in-laws/blood uncle-aunt-nephew-niece with over-50% support; NOT federal § 152) — $1,000/$500/$300 each by AL AGI (us.al.dependent_exemption); falls back to the shared dependents input | |
| alIs65Spouse | No | spouse was 65 or older — enables their own $6,000 exclusion | |
| arAge65Count | No | AR: number of taxpayers on the return who are 65 or over (0-2) — lets the composer add the '65 Special' $29 box when the Low Income Tax Table path forgoes the line 18 retirement exclusion (on the regular path count 65 Special yourself in arCreditBoxes) | |
| arFarmIncome | No | AR line 20: farm income (federal Schedule F), may be negative | |
| arIraTaxable | No | AR line 16: taxable NON-qualified IRA distributions (premature withdrawals), lump sums, and annuities — no $6,000 exclusion; pass the federal Form 5329 tax in arFederalEarlyWithdrawalTax | |
| arLumpSumTax | No | AR line 31: tax from the Lump Sum Distribution Averaging Schedule AR1000TD (transcribed) | |
| arOtherGains | No | AR line 15: other gains or losses (federal Form 4797 Part II; no capital loss limit) | |
| deExemptions | No | Form PIT-RES line 27a: number of federal exemptions (yourself, your spouse on a joint return, and dependents) at $110 each. A childless joint return enters 2. Enter 0 if you are claimed as a dependent on another return | |
| filingStatus | No | REQUIRED in practice: the federal filing status — drives the state bracket schedule, standard deduction column, and exemption structure. The filingJoint/filingHoh/filingHohOrQss booleans are legacy aliases; when filingStatus is present it wins. | |
| gaLic65Count | No | Low Income Credit Worksheet line 3: 1 if filer or spouse is 65+, 2 if both | |
| gaUetPenalty | No | Form 500 line 42: Form 500 UET estimated tax penalty | |
| hiOtherTaxes | No | HI Worksheet A-2 line 8: other deductible taxes | |
| hiReservePay | No | HI line 15: your military reserve / Hawaii National Guard duty pay (W-2 Box 16 from the reserve component) — the composer excludes the first $8,636 | |
| idBlindFiler | No | ID line 31: you or your spouse are legally blind at year end — no $10 permanent building fund tax (§ 63-3086); also check the line 12b box via ageOrBlindBoxes | |
| idUsInterest | No | ID Form 39R Part B line 3: interest from U.S. government obligations in federal AGI | |
| jurisdiction | Yes | ||
| ksUsInterest | No | KS Schedule S line A12: interest/dividends on U.S. government obligations included in federal AGI, net of related expenses (not FNMA/GNMA/FHLMC) | |
| mdPensionYou | No | primary taxpayer's qualifying § 401(a)/403/457(b) pension in FAGI for the Worksheet 13A pension exclusion — ONLY if 65+/totally disabled (or spouse totally disabled); IRAs/SEP/Keogh never qualify. The composer evaluates us.md.pension_exclusion per spouse. | |
| meUsInterest | No | ME Schedule 1S line 1: U.S. Government bond interest in federal AGI | |
| mnDependents | No | dependents on Schedule M1DQC — $5,200 each (2025), phased 2% per $2,500 ceil-step of AGI over $358,550 MFJ/QSS, $239,050 single, $298,800 HOH, $179,275 MFS (gone once the excess passes $122,500/$61,250-MFS); $0 for dependent-claimed filers | |
| mo529Deposit | No | MO-1040 line 52: refund deposited to a Missouri 529 (MOST) account (minimum $25, Form 5632) | |
| moFagiSpouse | No | MO-1040 line 1S: the spouse's share of federal AGI (combined returns). 1Y + 1S must equal the federal AGI. A NEGATIVE share triggers the 12 CSR 10-2.710 zeroing the composer applies (negative spouse $0, other spouse the netted joint FAGI; both $0 when combined FAGI is negative). | |
| moNrPayments | No | MO-1040 lines 39+40: MO-2NR/MO-2ENT nonresident partner/entertainer payments | |
| mt529Deposit | No | Form 2 line 25: amount of the refund deposited into a 529 or 529A account (must exceed $25 per account) | |
| ncCharitable | No | NC Schedule A: IRC § 170 charitable contributions allowed for the year (no NC dollar cap) | |
| ncTaxCredits | No | D-400 line 16: D-400TC total (other-state credit worksheet, historic rehab) — hand-computed; the composer caps at the line 15 tax. NC has NO EITC and NO child/dependent care credit. | |
| nePtetCredit | No | NE line 39: pass-through entity tax (PTET) credit from Schedules K-1N | |
| neUsInterest | No | NE Schedule I lines 15-17: interest and RIC dividends from U.S. government obligations exempt from state tax | |
| njBaitCredit | No | NJ-1040 line 63 pass-through Business Alternative Income Tax credit (PTE-K-1) | |
| njBlindCount | No | line 8 count (0-2): filer/spouse blind or disabled — $1,000 each | |
| nmAge65Count | No | NM: taxpayer and spouse who are 65 or older (0-2) — gates the $3,000 medical exemption, the $2,800 medical credit, the 65+ property tax rebate, and adds 2 LICTR exemptions each | |
| nmBlindCount | No | NM: taxpayer and spouse who are blind for federal purposes (0-2) — adds 1 LICTR rebate exemption each (PIT-RC line 2c) | |
| okEicAgi2024 | No | Form 511-EIC line 17 (Tax Year 2024 column): 2024 federal AGI — REQUIRED with okEicEarnedIncome2024 (the composer skips the 2024 column without it, since the line 19 AGI look-up cannot run) | |
| okUsInterest | No | OK Schedule 511-A line 1: interest on U.S. government obligations included in federal AGI (not FNMA/GNMA) | |
| orFederalAoc | No | American Opportunity Credit (1040 line 29) — subtracted in the federal tax worksheet | |
| orFederalPtc | No | premium tax credit from Form 8962 LINE 24 (the full allowable credit regardless of advance payments) — subtracted. NOTE: the EITC and additional child tax credit are NOT subtracted. | |
| orKidsUnder6 | No | dependents age 5 or younger at the end of 2025 (max 5 count) — $1,050 each Oregon Kids Credit (us.or.kids_credit, refundable, MFS denied). A child claimed only via a RELEASED dependent exemption does not count. | |
| riHr1Addback | No | RI Schedule M line 2k: add-back of federal H.R. 1 (P.L. 119-21) provisions from RI Schedule HR1 - Individual, line 1f (§ 44-30-12(b)(9)) — new for tax year 2025 | |
| scDependents | No | SC line w dependent count (must equal the federal return's) — $4,930 each for 2025 (us.sc.dependent_exemption); falls back to the shared dependents input | |
| scIs65Spouse | No | spouse was 65 or older by December 31 (lines p-2/q-2) | |
| scLumpSumTax | No | SC1040 line 7: tax on lump-sum distribution (SC4972, agent-computed, attached) | |
| subtractions | No | total state subtractions OTHER than the automatic ones (taxable social security / unemployment have their own inputs below; e.g. NY S-136 alimony paid, IL retirement subtraction) | |
| vaFamilyVagi | No | Schedule ADJ line 10 total family VAGI (you + spouse + dependents' VAGI) for the Credit for Low-Income Individuals poverty test; defaults to line 9 VAGI when omitted | |
| vaSpouseVagi | No | spouse's separate VAGI for the STA worksheet (Form 760 line 17 box; MFJ only) | |
| wi2441Credit | No | Schedule WI-2441 line 14 — Wisconsin's additional child and dependent care credit (its own recomputation; transcribe the schedule's result) | |
| wiAge65Boxes | No | count of 65-or-older boxes (taxpayer/spouse) — $250 each on line 10b (Wisconsin has no blindness exemption; the $700 line 10a exemptions come from the shared `exemptions` count) | |
| wiMarriedHoh | No | the Form 1 'Head of household, married' checkbox applies — shares the MFS $150 school property tax credit cap | |
| wvFederalAmt | No | WV: the filer paid federal alternative minimum tax — no Family Tax Credit, SCTC, or HEPTC | |
| wvUsInterest | No | WV Schedule M line 29 column A: interest/dividends on U.S. and West Virginia obligations exempt from state tax | |
| alAdjustments | No | Form 40 line 9 / Part II total (per-spouse IRA deduction, Keogh/SEP, early-withdrawal penalty, alimony paid, adoption expenses, MOVING EXPENSES (Alabama kept them), SE health insurance, College Counts 529/PACT, small-employer health premiums, wind/flood retrofit, catastrophe savings, HSA, First/Second-Chance Home Buyer, firefighter insurance, ABLE) | |
| alOtherIncome | No | Form 40 Part I lines 1-3 and 5-7 total EXCLUDING retirement (alimony received, business income/loss, gains — the 1/1/2025+ precious-metal-bullion gain is EXEMPT, rents/royalties/partnerships, farm; negative allowed). Retirement goes in the alTaxableRetirement* fields for the Schedule RS exclusion. | |
| arAdjustments | No | AR line 24: TOTAL adjustments from AR1000ADJ (IRA payments, HSA/MSA, student loan interest ≤ $2,500 with the $85,000-$100,000 / $170,000-$200,000 phase-out, tuition savings ≤ $5,000 per taxpayer, intergenerational trust ≤ $4,000, moving expenses, self-employed health insurance, Keogh/SEP/SIMPLE, early-withdrawal penalty, alimony paid, disabled-individual support $500, organ donor ≤ $10,000, reserve expenses, reforestation, teacher classroom expense, ABLE ≤ $5,000) — transcribed | |
| arAmendedPaid | No | AR line 42 (amended return only): previous payments with the original return and billing notices | |
| arCreditBoxes | No | AR line 7A: count of '65 or over', '65 Special' (65+ and NOT claiming the line 18 retirement exclusion), 'Blind', and 'Deaf' boxes for the taxpayer and spouse (0-8) — $29 each; the Yourself/Spouse/head-of-household boxes are added automatically | |
| arMilitaryPay | No | AR line 9: U.S. active-duty military compensation, household total (100% exempt; informational box; the W-2 wages must be excluded from `wages`). Under the Low Income Tax Table election it is counted as income in the primary's column | |
| arOtherIncome | No | AR line 22: net other income and depreciation differences from Form AR-OI (gambling winnings, cancellation of debt, taxable scholarships/stipends, HSA/MSA taxable distributions, PET back-outs, NOL carryforward as a negative, federal-vs-Arkansas depreciation), may be negative | |
| ctUseTaxTable | No | compute line 6 the way the DRS printed tax tables do (CT AGI ≤ $102,000: schedule at the $50 row midpoint, one rounding) instead of the Tax Calculation Schedule's line-level rounding — both are allowed by the form; default is the schedule | |
| deAge60OrOver | No | Form PIT-RES line 6: 60 or over on December 31 — the 60-or-over pension tier allows $12,500 of pension PLUS eligible retirement income; under 60 allows only $2,000 of pension | |
| gaNolUtilized | No | Form 500 line 15b: Georgia NOL utilized (Schedule 4; cannot exceed line 15a or the 80% limitation — composer caps at 15a) | |
| hiIhaPayments | No | HI line 16: cash paid into an individual housing account — the composer caps at $5,000 ($10,000 joint) | |
| hiSpouseAge65 | No | HI line 6b 'Age 65 or over' oval for the spouse (joint returns, or MFS with the spouse exemption) | |
| idFuelsTaxDue | No | ID line 27: fuels use tax due from Form 75 | |
| idSaltAllowed | No | ID line 14 input: Schedule A line 5e taxes allowed after the federal cap (used when 5a+5b+5c exceeds $40,000 / $20,000 MFS) | |
| idStateRefund | No | ID Form 39R Part B line 2: state income tax refund included in federal income (Schedule 1 line 1) | |
| ilK12Expenses | No | IL Schedule ICR Section B qualified K-12 education expenses before the $250 floor — tuition, book/lab fees at a public, nonpublic OR home school that satisfies the truancy law (105 ILCS 5/26-1; IDOR Pub. 112); the composer takes 25% of the excess over $250, maximum $750 | |
| ksAmendedPaid | No | KS line 24 (amended return only): payments remitted with the original return | |
| ksK120sCredit | No | KS line 25: credit for the 5.58% tax paid on the filer's behalf by electing pass-through entities (Form K-9 Part C) | |
| ksStateRefund | No | KS Schedule S line A13: state or local income tax refund included in federal AGI (Schedule 1 line 1) | |
| ksStillbirths | No | certified stillbirths during the tax year — $2,320 exemption each | |
| md502crPartBB | No | MD line 31: local tax credit from Form 502CR Part BB line 1 | |
| mdCtcChildren | No | Maryland CTC qualified children (dependents under 6, or over 5 and under 17 with a disability) — the composer evaluates us.md.ctc ($500/child, phased out $50 per $1,000 of FAGI over $15,000, $0 above $24,000; refundable via 502CR Part CC into line 45) | |
| mdSubdivision | No | REQUIRED for MD: the taxing county where the filer resided on the LAST day of the tax year (Form 502 political-subdivision box) — one of baltimore_city, allegany, anne_arundel, baltimore_county, calvert, caroline, carroll, cecil, charles, dorchester, frederick, garrett, harford, howard, kent, montgomery, prince_georges, queen_annes, st_marys, somerset, talbot, washington, wicomico, worcester, nonresident. Drives the mandatory local tax (line 28: flat 2.25%-3.30%; Anne Arundel bracketed with its own printed table; Frederick tiered on the WHOLE income with real cliffs). | |
| meMilitaryPay | No | ME Schedule 1S line 5: non-Maine active duty military pay of a Maine resident | |
| meSaltTaxes5e | No | ME Schedule 2 line 2a: taxes paid included in the federal total (Schedule A line 5e) — removed | |
| meStateRefund | No | ME Schedule 1S line 2: state income tax refund in federal AGI | |
| meTotalIncome | No | ME Schedule PTFC/STFC line 3: total income = federal total income (Form 1040 line 9) + Social Security/railroad benefits not in it + tax-exempt interest + loss add-backs — REQUIRED for the Property Tax Fairness Credit and used for the Sales Tax Fairness Credit (defaults to federal AGI when omitted, with a note) | |
| mnStateRefund | No | M1 line 6: state income tax refund from federal Schedule 1 line 1 (its own subtraction line) | |
| moFederalTax9 | No | MO-1040 line 9 'Tax from federal return': federal 1040 line 22 MINUS lines 27a and 29, MINUS Schedule 2 Part 1 line 3, MINUS Schedule 3 Part 2 line 9 — never withholding; the EIC must be subtracted | |
| moSsExemptYou | No | the primary's MO-A Section C exemption: their TAXABLE Social Security/SSD (1040 line 6b share), 100% exempt — pass ONLY if 62+ by December 31 (the MO-1040 age box) or on Social Security Disability (attested) | |
| mtSpouseAge65 | No | Form 2 line 6: your spouse attained age 65 — a second $5,660 subtraction, on a JOINT return only (a qualifying surviving spouse has no spouse) | |
| ndMilitaryPay | No | Form ND-1 line 11: military pay of a member of the armed forces on active or reserve duty or of the national guard, excluded IN FULL with no cap — including federal pay for training, education, mobilization and bonuses, and state pay on state active duty | |
| neAmendedPaid | No | NE line 52 (amended return only): amount paid with the original return plus later payments | |
| neStateRefund | No | NE Schedule I line 14: state income tax refund included in federal AGI (Schedule 1 line 1) | |
| neUseTaxTable | No | NE line 15: compute from the paper Nebraska Tax Table (row midpoints, endpoint worksheet over $77,760) instead of the Tax Calculation Schedule e-filers must use — they differ by up to $3 (the table prices each $100 row at its midpoint) | |
| njAlimonyPaid | No | NJ-1040 line 32 court-ordered alimony PAID (still deductible for NJ; never child support) | |
| njBusinessNet | No | NJ-1040 line 18 net profits from business (Schedule NJ-BUS-1 Part I; negative allowed — the composer suppresses a net category loss per the printed rule) | |
| njFederalCdcc | No | the federal Form 2441 child and dependent care credit — enables the line 64 NJ CDCC (us.nj.cdcc: 50%→10% of it by NJ taxable income, $150,000 cap) | |
| njGamblingNet | No | NJ-1040 line 24 net gambling winnings (losses net WITHIN the category; NJ Lottery prizes of $10,000 or less are exempt) | |
| njMfsSameHome | No | MFS and both spouses maintained the SAME main home — halves the property-tax deduction cap ($7,500) and credit ($25) | |
| njNjclassPaid | No | NJ-1040 line 37b NJCLASS loan principal+interest paid (composer caps at $2,500) | |
| njOtherIncome | No | NJ-1040 line 26 other income | |
| njSeniorCount | No | line 7 count (0-2): filer/spouse 65 or older (born 1960 or earlier for TY2025) — $1,000 each | |
| njTuitionPaid | No | NJ-1040 line 37c NJ-institution tuition paid (composer caps at $10,000) | |
| nmLatePenalty | No | NM PIT-1 line 36: late filing/payment penalty — 2% of the unpaid line 33 tax per month or part, maximum 20% | |
| nmSaltAllowed | No | NM line 10 worksheet line 4: federal Schedule A line 5e (state and local taxes deducted after the cap) | |
| ohEicOverride | No | OVERRIDE: us.oh.eic oracle answer — wins over the composer's 30%-of-federalEITC line 13 computation | |
| okAmendedPaid | No | OK line 30 (amended return only): amount paid with the original return plus additional payments after it was filed | |
| okEicEligible | No | Form 511-EIC eligibility under the FEDERAL 2020 rules attested: work-valid SSNs, not married filing separately, investment income $3,650 or less, and with no qualifying child age 25-64 and not a dependent — enables the Oklahoma EIC (line 28) | |
| okMilitaryPay | No | OK Schedule 511-C line 1: active-duty, Reserve, and National Guard military pay included in federal AGI (100% excluded) | |
| okPtrEligible | No | Form 538-H gates attested: 65 or older OR totally disabled, head of a household (owner who maintained the home — the 538-H definition, not the filing status), domiciled in Oklahoma the entire year — enables the property tax relief credit (line 24; also needs gross household income ≤ $12,000) | |
| okStrDisabled | No | taxpayer or spouse has a physical disability constituting a substantial handicap to employment (proof attached) — raises the sales tax relief limit to $50,000 | |
| okStrEligible | No | Form 538-S gates attested: Oklahoma resident (domiciled) the ENTIRE year, no TANF in any month, not a DOC inmate during the year after a felony conviction, not living in Oklahoma under a visa, and the return is filed by the due date — enables the sales tax relief credit (line 25) | |
| or529Deposits | No | OR-40 line 51: Oregon 529 deposits from Schedule OR-529 (reduce the refund) | |
| orPtePayments | No | OR-40 line 36: estimated payments from Schedule OR-K-1 line 20 (PTE owner payments via Form OR-19) | |
| orStateRefund | No | OR-40 line 12: OREGON state income tax refund from federal Schedule 1 line 1 (never other states' or local refunds) | |
| paBusinessNet | No | PA-40 line 4, TAXPAYER's own net business/profession/farm income or LOSS (negative allowed; within-class netting of the taxpayer's own activities only — a loss never crosses classes or spouses) | |
| paEstateTrust | No | PA-40 line 7: estate/trust income (PA Schedule J; an estate or trust cannot distribute a loss — never negative) | |
| paPropertyNet | No | PA-40 line 5, taxpayer's own net gain/loss from sale/exchange/disposition of property (negative allowed; no carryover) | |
| wvAmendedPaid | No | WV line 22 (amended only): amount paid with the original return | |
| wvStateRefund | No | WV Schedule M line 38: state and local income tax refunds included in federal income | |
| arEarnedIncome | No | AR2441 line 4: the taxpayer's earned income | |
| arExemptIncome | No | AR Low Income Tax Table test only: income NOT on lines 8-22 (Social Security, VA benefits, workers' compensation, Railroad Retirement, U.S./Arkansas obligation interest, the $250,000/$500,000 residence gain) — qualification 1 counts 'total income from all sources (regardless of whether the income is taxable to Arkansas)'; the exempt half of long-term capital gains and the forgone retirement/military exclusions are added automatically | |
| arInterestPaid | No | AR3 lines 8-11: home mortgage interest, deductible points, investment interest (≤ investment income) | |
| arLongTermGain | No | AR line 14 via AR1000D: net LONG-TERM capital gain or loss (federal Schedule D line 15, adjusted for Arkansas depreciation) — 50% of a net long-term gain is exempt; gain over $10,000,000 exempt | |
| arMiscExpenses | No | AR3 lines 20-21: unreimbursed employee business expenses (AR2106), union dues, tax preparation fees, and other deductions SUBJECT to the 2%-of-AGI floor (applied by the rule) | |
| arSpouseIncome | No | AR status 4 column B: the SPOUSE's share of lines 8-22 (wages, interest, dividends, business, capital gains, rents, other) — the primary's column A is the household total minus this; line 18B (spouse pension) is added automatically. Business/farm income cannot be split without a partnership | |
| caHsaDeduction | No | federal HSA deduction (Form 8889 line 13) — California does not conform to § 223: the composer ADDS it back for CA | |
| ctLateInterest | No | CT-1040 line 28: late payment interest — 1% of line 26 per month or fraction of a month from the due date (agent-computed) | |
| deAge60Persons | No | Form PIT-RES line 27b: persons 60 or over on December 31 (you and/or your spouse) — an additional $110 each | |
| deEarnedIncome | No | Form PIT-RES line 11 worksheet: earned income (wages, tips, farm or business income) — must be under $2,500, or under $5,000 on a joint return, for the elderly/disabled exclusion | |
| filingHohOrQss | No | ||
| gaIndCrCredits | No | Form 500 line 20: IND-CR Summary total OTHER than the CDCC (the composer adds us.ga.cdcc itself from gaFederalCdccAllowed) | |
| hiEarnedIncome | No | HI earned income (wages, tips, net self-employment less the SE tax deduction) — REQUIRED for a dependent filer's standard deduction and for the Schedule X child care credit earned-income limit | |
| idEarnedIncome | No | ID earned income — REQUIRED for a filer claimable as a dependent (the standard deduction is the larger of $1,350 or earned income + $450, capped) and for the Form 39R child care deduction | |
| idQbiDeduction | No | ID line 18: federal Form 1040 lines 13a + 13b (qualified business income deduction and Schedule 1-A deductions) — subtracted from Idaho income | |
| ilChildUnder12 | No | IL CTC gate: a QUALIFYING CHILD (§ 152(c) lineage — child/stepchild/foster/sibling or their descendants) under age 12. A qualifying-relative/ODC-only dependent does NOT satisfy this even if under 12; leave false. | |
| ilEitcOverride | No | us.il.eitc oracle target's answer (35 ILCS 5/212(a)(vi), (b-5), (b-10): 20% of the federal EITC recomputed WITHOUT the § 32(c)(1)(A)(ii) childless age gate) — WINS over the generic 20%-of-federalEITC line-29 computation when present. MUST be used (not merely optional) for a taxpayer age 18-24 or 65+ with NO qualifying children: federalEITC alone is correctly $0 for that population under federal law, so line 29 = 20% x federalEITC would wrongly zero out Illinois' decoupled credit — pass us.il.eitc's computed answer instead. Safe to pass for every IL EITC claimant (agrees with the generic computation outside the decoupled population). | |
| mdEarnedIncome | No | MD line 1b earned income (wages + net SE profit, no loss netting) — the poverty level credit base (us.md.poverty_level_credit) and the local poverty credit (19C) | |
| mdStateRefunds | No | MD line 8: taxable state/local income tax refunds included in federal AGI (subtraction) | |
| mnSubtractions | No | M1 line 7 subtractions (M1M line 40 + M1MB line 22) EXCLUDING the composer-computed Social Security subtraction: U.S. government interest, K-12 education expenses, charitable over $500 for non-itemizers (50% of the excess), bonus-depreciation recovery, M1R age-65+/disabled, M1QPEN public pension, military items, the new 2025 items (coerced debt, consumer enforcement, foreign service, SEIU stipends) | |
| moAdditionsYou | No | MO-A Part 1 line 7Y: the primary's additions (non-Missouri state/local bond interest, PTE/NOL addbacks, nonqualified 529/ABLE distributions, food pantry, nonresident property tax) | |
| moLtcDeduction | No | MO-1040 line 16: qualified long-term care insurance premiums (12+ month policies, net of federally deducted amounts, per the worksheet) | |
| neEarnedIncome | No | NE Form 2441N line 4: the taxpayer's earned income | |
| njEitcOverride | No | OVERRIDE: us.nj.eitc oracle answer — wins over the composer's 40%-of-federalEITC / $260 computation | |
| njHezDeduction | No | NJ-1040 line 34 Health Enterprise Zone deduction (TB-56) | |
| njVeteranCount | No | line 9 count (0-2): filer/spouse honorably-discharged veterans — $6,000 each | |
| nmExpansionEic | No | NM PIT-1 line 25a (NM Expansion, box 25b): the federal EIC the filer WOULD have received but for the SSN or under-25 age rule — used when federalEITC is 0 | |
| nmRebateCounty | No | NM PIT-RC Section 4: the owner-occupied principal residence is in Los Alamos, Santa Fe, Doña Ana, or Bernalillo County — additional low income property tax rebate (MGI ≤ $24,000) | |
| ohAge65OrOlder | No | filer (or spouse) was 65 or older at year end — $50 senior citizen credit (once per return; NOT available if the lump sum distribution credit was ever taken) | |
| orKickerDonate | No | filer elects to donate the ENTIRE kicker to the State School Fund (irrevocable after the due date) — line 32 becomes $0 and box 55 is checked | |
| orSubtractions | No | OR-40 line 13: Schedule OR-ASC line B7 subtractions — including the OBBBA-conforming tips/overtime/passenger-vehicle-interest deductions (codes 390/391/392: Oregon lets you claim the same amounts as federal), US government interest, the federal pension percentage subtraction, OR-HOME first-time home buyer savings, tier 2 Railroad Retirement. Do NOT include Social Security (automatic via taxableSocialSecurity). | |
| scCareChildren | No | count of qualifying care children/dependents — 2+ raises the SC CDCC cap from $210 to $420 | |
| scCareExpenses | No | federal Form 2441 child/dependent care EXPENSES (not the credit) — SC line 11 pays 7%, max $210/$420 (us.sc.cdcc); DENIED to married filing separately | |
| scI290Payments | No | SC1040 line 19: nonresident real estate withholding paid on Form I-290 | |
| vaAgeDeduction | No | OVERRIDE ONLY — pass vaAgeQualifyingFull/vaAgeQualifyingTested instead and the composer computes the age deduction itself (including the AFAGI social-security exclusion agents routinely miss). When splitting an odd joint total between spouses (Form 760 lines 4a/4b), the odd dollar goes to the SPOUSE. | |
| wvEarnedIncome | No | WV line 5 low-income exclusion: earned income (wages, salaries, tips, net self-employment) — REQUIRED when federal AGI is $10,000 or less ($5,000 MFS) for the exclusion to be computed | |
| ageOrBlindBoxes | No | count of age-65+/blind boxes checked (taxpayer/spouse, per box); NE line 2a: +$2,000 single/HOH or +$1,650 married/QSS each | |
| alAtpOtherTaxes | No | Schedule ATP Part I taxes OTHER than the use tax (which uses the shared useTax input): catastrophe-savings recapture (+2.5%), etc. | |
| arAmendedRefund | No | AR line 45 (amended return only): previous refund(s) from the original and earlier amended returns (subtracted) | |
| arContributions | No | AR3 lines 13-16: cash, art/literary, other, and carryover contributions | |
| arCreditForward | No | AR line 48: overpayment to apply to 2026 estimated tax (credited to the primary filer only) | |
| arShortTermGain | No | AR line 14 via AR1000D: net SHORT-TERM capital gain (100% taxed) or loss (federal Schedule D line 7); the net loss is limited to $3,000 ($1,500 per taxpayer for status 4/5). For a status-4 comparison this is the PRIMARY's own column — the spouse's gains go in arSpouseLongTermGain / arSpouseShortTermGain | |
| caIsoPreference | No | ISO exercise spread AMT preference (§ 56(b)(3) as modified by R&TC § 17062) — with caAmtTaxesAddback this lets the composer BUILD Schedule P AMTI itself (AMTI = line 19 taxable income + taxes deducted in the CA itemized deduction + this preference; standard deduction added back instead when not itemizing) and evaluate us.ca.amt internally; caAmt (a precomputed answer) wins if both are given | |
| caRentersCredit | No | us.ca.renters_credit result (pass the oracle target's answer) — nonrefundable, joins the exemption credits in the line-48 subtraction from tax. | |
| cityWithholding | No | NY line 73 NYC withholding | |
| ctEitcJointFagi | No | Schedule CT-EITC line 13: the JOINT federal AGI when the filer filed jointly federally but must file married-filing-separately for Connecticut — the composer prorates the 40% credit by federalAGI (this spouse's separate AGI, line 12) ÷ this amount to four decimals | |
| dePensionIncome | No | Form PIT-RES line 6: pensions from employers, the United States, this State or its subdivisions. Excludes early distributions (1099-R box 7 code 1, or an early-withdrawal penalty) and employer-paid disability pension income before minimum retirement age | |
| gaExclusionTier | No | primary taxpayer's GA retirement-exclusion tier: 62-64 during any part of the year or permanently/totally disabled ($35,000 cap) vs 65+ ($65,000 cap) (us.ga.retirement_exclusion) | |
| gaLicExemptions | No | Low Income Credit Worksheet line 2: self + spouse + natural/legally adopted children (never other dependents or unborn) (us.ga.low_income_credit) | |
| hiCreditForward | No | HI line 46: overpayment to apply to 2026 estimated tax | |
| hiOtherFormsTax | No | HI line 27: additional tax from Forms N-2, N-103, N-152, N-168, N-312, N-325, N-338, N-344, N-348, N-405, N-586, N-615, N-814 (Tax Computation Worksheet lines c-m) | |
| hiTaxpayerAge65 | No | HI line 6a 'Age 65 or over' oval: you were 65 or older as of January 1, 2026 — one extra $1,144 exemption | |
| ksCreditForward | No | KS line 34: overpayment applied to 2026 estimated tax ($1 or more) | |
| ksPropertyTaxes | No | KS Schedule A lines 5-6: state and local real estate taxes plus value-based personal property taxes (100%, no SALT cap; NO income or sales taxes) | |
| mdContributions | No | MD lines 35-39: voluntary fund contributions total (reduces the refund) | |
| mdHouseholdSize | No | persons in the family/household from the federal return — enables the poverty level credit computation (2025 guideline $15,650 + $5,500 each additional person) | |
| mdPensionSpouse | No | spouse's qualifying pension for their own 13A column (same gates) | |
| mdRangerPension | No | MD line 10b: Retired Forest/Park/Wildlife Ranger pension exclusion (Worksheet 13E, agent-computed, disclosed) | |
| meContributions | No | ME line 31: Schedule CP charitable contributions and park passes | |
| meCreditForward | No | ME line 34a: overpayment to credit to 2026 estimated tax | |
| mnOtherTaxes14a | No | M1 line 14a: M1HOME/M1529 recapture, M1LS lump-sum tax, and the Schedule NIIT amount if computed outside the composer | |
| mnRrTier1Offset | No | Tier 1 Railroad Retirement benefits already subtracted on M1M line 17 — the SS worksheet (steps 25-29) reduces the simplified-method subtraction by this amount (no double subtraction) | |
| moHcsmDeduction | No | MO-1040 line 17: health care sharing ministry contributions not deducted federally | |
| moOtherTaxesYou | No | MO-1040 line 34Y: 10% of the Federal Form 4972 lump-sum distribution tax, and/or recapture of the low income housing credit (Form 8611) — the printed checkboxes. (Form 4970 trust accumulation amounts are a SUBTRACTION, not a line 34 tax.) | |
| mtTaxpayerAge65 | No | Form 2 line 6: you attained age 65 — a $5,660 subtraction for 2025 | |
| ncScorpPayments | No | D-400 line 21d: NC tax paid by an S corporation on the filer's behalf | |
| neCreditForward | No | NE line 61: overpayment applied to 2026 estimated tax | |
| neOtherStateAgi | No | NE Schedule II line 2: adjusted gross income derived from another state per the DOR Conversion Chart (not that state's taxable income) | |
| njExcessUiWfSwf | No | NJ-1040 line 59 excess UI/WF/SWF withheld (two+ employers over $184.02; Form NJ-2450) | |
| nmContributions | No | NM PIT-1 line 40: PIT-D voluntary contributions from the overpayment | |
| nmCreditForward | No | NM PIT-1 line 41: overpayment applied to 2026 estimated tax | |
| nmLumpSumAmount | No | NM PIT-1 line 19: the lump-sum distribution amount taxed under the federal 10-year option (Form 4972) — New Mexico adds 5 × the tax on 20% of it | |
| nmOtherStateTax | No | NM PIT-1 line 20 worksheet (column 2 line 1): income tax due to the other state (not withholding; not a city or county tax) | |
| okAdditionalTax | No | OK line 14b: HSA non-qualified withdrawal 10% additional tax (box 2), Oklahoma Affordable Housing credit recapture (box 3), or IRC § 965(h) installment (box 4) | |
| okForm578Credit | No | OK line 27: refundable credit for electricity generated by zero-emission facilities from Form 578 (85% of face; transcribed) | |
| okStrExemptions | No | Form 538-S Box D qualified exemptions (yourself + spouse + federally-claimed dependents who were Oklahoma residents all year; the 65+/blind boxes NEVER count) — $40 each; defaults to the shared `exemptions` count | |
| scContributions | No | SC1040 line 28: check-off contributions total (I-330 attached; reduces the refund) | |
| scLatePenalties | No | SC1040 line 32: late filing/late payment penalties and interest | |
| scTuitionCredit | No | SC1040 line 21: REFUNDABLE tuition tax credit (Form I-319: 50% of qualifying SC-institution tuition within the form's limits — agent-computed with disclosure, form attached) | |
| vaItemizedOther | No | VA Sch A other itemized deductions | |
| wiBothSpouses67 | No | both spouses 67+ on December 31 (joint returns) — raises the SB-16 cap to $48,000 | |
| wvActiveDutyPay | No | WV Schedule M lines 36-37: qualifying active duty (Title 10 contingency operations) and active military separation pay | |
| wvAmendedRefund | No | WV line 11 (amended only): overpayment previously refunded or credited | |
| wvBuildWvCredit | No | WV line 20: Build WV Property Value Adjustment refundable credit (Schedule PVA-2) | |
| wvCreditForward | No | WV line 27: overpayment to credit to 2026 estimated tax | |
| wvHouseholdSize | No | WV SCTC / HEPTC: number of people living in the household (defaults to 1 + spouse + dependents) | |
| wvOtherStateTax | No | WV Schedule E line 1: income tax computed on the other state's return (not withholding; not city taxes) — attach nothing, keep the return | |
| arBusinessIncome | No | AR line 13: net business or professional income (federal Schedule C), may be negative | |
| arCasualtyLosses | No | AR3 line 18: casualty and theft losses from AR4684 (after the $100 exclusion and 10%-of-AGI test) | |
| arRentsRoyalties | No | AR line 19: rents, royalties, partnerships, estates, trusts (federal Schedule E), may be negative | |
| extensionPayment | No | payment made with an extension request. VA 760 line 22 (its own line, never folded into the estimated-payments line). NY IT-201 line 75 is the COMBINED line — 'estimated tax payments and amount paid with Form IT-370' — so for NY this is added into the same line as estimatedPayments, not kept separate. | |
| gaDependentCount | No | Form 500 line 7c total dependents (7a qualified + 7b unborn-with-heartbeat; never self/spouse) — $4,000 each (us.ga.dependent_exemption) | |
| hiCasualtyLosses | No | HI Worksheet A-5 line 19: casualty and theft losses after $100 per casualty, before the 10%-of-AGI floor (any casualty, not only federal disasters, for 2025) | |
| hiNetCapitalGain | No | HI Tax on Capital Gains Worksheet line 7: Hawaii net capital gain (federal Schedule D line 16 plus Hawaii adjustments) — with hiNetLongTermCapitalGain triggers the 7.25% alternative tax when taxable income exceeds the worksheet threshold | |
| hiOutOfStateLtcg | No | HI other-state worksheet line 4: long-term capital gains from sources outside Hawaii | |
| hiSpouseDisabled | No | HI line 25: with ONE disabled person on a joint return, the disabled person is the spouse (default: the taxpayer) — decides whose age-65 status gives the non-disabled spouse $2,288 instead of $1,144 | |
| hiSpouseItemizes | No | HI line 21: married filing separately and the spouse itemizes — you MUST itemize (no standard deduction) | |
| hiWageDifference | No | HI line 8: W-2 Box 16 state wages over Box 1 federal wages (COLA, LQA, ERS contributory/hybrid plan members) | |
| idEntityPayments | No | ID line 48: Idaho tax paid or withheld by a pass-through entity or ABE (Form ID K-1) | |
| idFuelsTaxRefund | No | ID line 45: special fuels / gasoline tax refund from Form 75 | |
| idNetCapitalGain | No | ID: capital gain net income from all property included in taxable income — caps the capital gains deduction | |
| idRequiredToFile | No | ID line 31: set false when gross income is below the Idaho filing threshold (single $15,750 / $17,750 at 65+; MFJ $31,500; HOH $23,625; MFS $5) — no $10 permanent building fund tax; defaults to true | |
| idSpouseItemizes | No | ID married filing separately: the spouse itemizes — the filer MUST itemize (standard deduction $0); pass idFederalItemized and the Schedule A amounts | |
| meUseTaxEstimate | No | ME line 30: also add the 0.04%-of-Maine-AGI estimate for unknown untaxed purchases | |
| moCapitalGainYou | No | the primary's share of federally reported capital gains (Form 1040 line 7a) — the composer subtracts 100% (MO-A line 18, H.B. 594, NEW for TY2025; a negative amount enters as $0) | |
| moSsExemptSpouse | No | the spouse's Section C SS/SSD exemption on the same gates | |
| mtResided9Months | No | Schedule 2EC: the claimant resided in Montana at least nine months during the year | |
| ncUseTaxEstimate | No | use the printed no-receipts consumer use tax table (keyed to line 14 taxable income, us.nc.use_tax) instead of the useTax input | |
| neK1nWithholding | No | NE line 38: Nebraska income tax withheld reported on Schedules K-1N | |
| njAbcaAdjustment | No | NJ-1040 line 35 Alternative Business Calculation Adjustment (Schedule NJ-BUS-2 line 11 — the only cross-category loss softener, 20-year carryforward) | |
| njChildrenUnder6 | No | count of line 10/11 dependents age 5 or younger on 12/31 (born 2020 or later for TY2025) — the line 65 NJ Child Tax Credit multiplier ($1,000→$200 each by taxable income ≤ $80,000; MFS ineligible) | |
| njDispositionNet | No | NJ-1040 line 19 net gains from disposition of property (Schedule NJ-DOP; NO capital-gain preference, NO loss carryover; negative allowed — suppressed) | |
| njGoldStarCredit | No | NJ-1040 line 47 Gold Star Family Counseling Credit (hours × TRICARE rate) | |
| njPartnershipNet | No | NJ-1040 line 21 distributive share of partnership income (NJK-1; negative suppressed) | |
| njRentRoyaltyNet | No | NJ-1040 line 23 net rents/royalties/patents/copyrights (negative suppressed) | |
| nmNetCapitalGain | No | NM PIT-ADJ line 16: net capital gain (§ 1222(11), net long-term gain over net short-term loss) — up to $2,500 deducted | |
| nmPteWithholding | No | NM PIT-1 line 29: New Mexico tax withheld by or paid as entity-level/composite tax by pass-through entities (RPD-41359) | |
| nycTaxableIncome | No | NYC taxable income (IT-201 line 47) if NYC resident | |
| ohBusinessIncome | No | OH Schedule of Business Income Part 1 line 10: total business income (Schedule B/C/D/E/F + guaranteed payments to 20%+ owners + § 4797) — the composer runs the $250,000/$125,000 Business Income Deduction and the flat-3% line 6/8b arithmetic from it | |
| ohResidentCredit | No | OH Schedule of Credits line 39 resident credit for taxes paid other states (Ohio IT RC, hand-computed) | |
| okCsrsRetirement | No | OK Schedule 511-A line 3: Federal Civil Service Retirement System benefits paid in lieu of Social Security (100% excluded; CSA/CSF 1099-R claim number required — FERS does not qualify except the CSRS component or the FERS annuity supplement) | |
| okFederalCharity | No | federal Schedule A line 14 gifts to charity — exempt from the $17,000 Oklahoma cap | |
| okFederalMedical | No | federal Schedule A line 4 medical and dental (after the 7.5% floor) — exempt from the $17,000 Oklahoma cap | |
| okUseTaxEstimate | No | filer kept no records of out-of-state purchases and elects the printed Use Tax Table estimate on federal AGI for line 19 (us.ok.use_tax — the 2025 table; for a TY2026 return the estimate REFUSES until the 2026 packet publishes, pass useTax instead) — otherwise pass useTax (worksheet amount) or nothing (certify no use tax is due) | |
| orSpouseItemizes | No | MFS only: the other spouse itemizes — the Oregon standard deduction becomes $0 | |
| orYoungestUnder3 | No | the youngest dependent was younger than 3 at year end — raises the Oregon EIC from 9% to 12% of the federal EITC (us.or.eic) | |
| paRentRoyaltyNet | No | PA-40 line 6, taxpayer's own net rents/royalties/patents/copyrights (short-term rentals under 30 days are BUSINESS income, line 4) | |
| paResidentCredit | No | PA-40 line 22: resident credit for tax paid other states (Schedule G-L; not for reciprocal-state compensation: IN/MD/NJ/OH/VA/WV). Subtracts BEFORE Tax Forgiveness — the composer handles the ordering. | |
| scActiveTradeTax | No | SC1040 line 8: I-335 flat 3% tax on active trade or business income (agent-computed; the electing income must also appear in scSubtractionsOther as the line l subtraction) | |
| scCatastropheTax | No | SC1040 line 9: tax on excess Catastrophe Savings Account withdrawals | |
| stateWithholding | No | state income tax withheld (IL line 25 / VA 19a / CA 71 / NY 72). CONVENTIONS: IL line 25 sums state withholding from EVERY document (W-2s + all 1099s). NY line 72 = total NYS tax withheld from EVERY W-2 box 17, 1099-R box 14, 1099-G box 11, 1099-NEC/MISC state boxes and W-2G — wherever the state box reads NY; the PAYER'S mailing address is irrelevant (an out-of-state payer's NY-coded withholding IS included — IT-201-I line 72). VA 19a = the PRIMARY taxpayer's withholding from EVERY document type (W-2, 1099, VK-1 — Form 760 line 19 instructions name all three; the payer's address does NOT matter for VA, unlike NY); a jointly-issued document's state withholding splits 50/50 between 19a/19b with the odd dollar to the primary. | |
| vaRefundableEitc | No | OVERRIDE ONLY — the composer now computes the Form 760 line 23 credit itself from federalEITC + the eligibility inputs below. If passed, this refundable amount wins over the computed selection. | |
| wiFarmlandCredit | No | Form 1 line 31: farmland preservation credit (Schedules FC/FC-A, transcribed) | |
| wiOtherPenalties | No | Form 1 line 26 other penalties (see instructions p.25) | |
| wiVeteransCredit | No | Form 1 line 34: eligible veterans and surviving spouses property tax credit | |
| wvGamblingLosses | No | WV Schedule M line 46: gambling losses (not more than winnings; federal itemizers only) | |
| yonkersSurcharge | No | us.ny.yonkers_surcharge result (pass the oracle target's answer) — 16.75% of the Yonkers worksheet's netted base (nyYonkersBase). Added into line 62's total and printed on its own line (IT-201 LINE 55, not 54 — line 54 is MCTMT) when nonzero. | |
| arAlimonyReceived | No | AR line 12: alimony and separate maintenance received under a court order | |
| arMedicalExpenses | No | AR3 line 1: medical and dental expenses paid — the 10%-of-AGI floor is applied by the rule | |
| arWithholding1099 | No | AR line 39B: Arkansas tax withheld on 1099-R, 1099-PT, and AR-K1 forms (new separate line for 2025; W-2 withholding goes in stateWithholding → line 39A) | |
| caAmtTaxesAddback | No | taxes actually included in the CA itemized deduction (property taxes etc. surviving the Schedule CA SALT adjustments) — the Schedule P line 2 addback used when the composer builds AMTI from caIsoPreference; $0 when not itemizing (the composer adds back the standard deduction instead) | |
| ctSsTotalBenefits | No | federal Social Security Benefits Worksheet line 1 (total benefits, SSA-1099 box 5) — with taxableSocialSecurity and ctSsProvisionalExcess the composer runs the CT Social Security Benefit Adjustment Worksheet (line 41) when federal AGI is at or above $75,000 (single/MFS) or $100,000 (MFJ/QSS/HOH); below the threshold the full taxable amount is subtracted automatically | |
| deMilitaryPension | No | Form PIT-RES line 6 checkbox: the pension is a United States military pension — raises the UNDER-60 exclusion from $2,000 to $12,500. Since 84 Del. Laws c. 437 the definition covers the Army, Navy, Air Force, Marine Corps, Space Force, Coast Guard, the NOAA and Public Health Service commissioned corps, and the National Guard | |
| deSpouseAdditions | No | COLUMN A: the spouse's Delaware additions (non-Delaware municipal bond interest, oil depletion, fiduciary adjustment) | |
| deUseRateSchedule | No | Form PIT-RES line 24: compute from the rate schedule at the exact taxable income instead of the printed Tax Table (under $60,000 the table's row midpoint governs by instruction; $60,000 or more always uses the schedule) | |
| estimatedPayments | No | state estimated payments ONLY (extension payments and prior-year credited overpayments have their own lines where the form provides them) | |
| gaFederalItemized | No | Form 500 line 12a: federal Schedule A total. Supplying this FORCES Georgia itemizing ('Leave Line 11 blank if you itemize deductions on your Federal return') — a federal standard-deduction filer must omit it. | |
| hiDisabledPersons | No | HI line 25 ovals: taxpayers (you and/or your spouse, 0-2) claiming the $7,000 blind/deaf/totally disabled exemption (Form N-172) in lieu of ALL regular exemptions — no dependent or age-65 exemptions with it | |
| hiMedicalExpenses | No | HI Worksheet A-1 line 1: medical and dental expenses before the 7.5%-of-Hawaii-AGI floor | |
| hiRealEstateTaxes | No | HI Worksheet A-2 line 6: real estate taxes (no foreign real property taxes; no $10,000 cap) | |
| hiUseRateSchedule | No | HI line 27: compute from the Tax Rate Schedules at the exact income instead of the Tax Table (taxable income under $100,000 uses the table by instruction; $100,000 or more always uses the schedules) | |
| idApplyToNextYear | No | ID line 56: part of the overpayment to apply to 2026 estimated tax | |
| idBusinessCredits | No | ID line 23: Form 44 Part I business income tax credits | |
| idCreditRecapture | No | ID lines 29-30: recapture of income tax credits (Form 44 Part II) and of the qualified investment exemption (Form 49ER) | |
| idFederalItemized | No | ID lines 13-17: the filer itemized on the federal return — Idaho then uses the LARGER of the federal standard deduction and federal itemized deductions minus state and local income or sales taxes (pass idFederalItemizedDeductions and the Schedule A tax lines) | |
| idLtcPremiumsPaid | No | ID Form 39R Part B line 19: qualified long-term care insurance premiums paid (worksheet line 11) | |
| idPriorYearCredit | No | ID line 53: nonrefundable credit from a prior year return (Form 44) | |
| idRealEstateTaxes | No | ID line 14 input: Schedule A line 5b real estate taxes | |
| idSchALtcPremiums | No | ID health/LTC worksheet line 2: long-term care premiums included on federal Schedule A | |
| idUseTaxPurchases | No | ID line 28: purchases on which no Idaho sales tax was paid (online, mail order, out-of-state) — 6% | |
| ilPropertyTaxPaid | No | IL property tax on principal residence, net of business-use portion | |
| ilTeacherExpenses | No | IL Schedule 1299-C / 1299-I Instructional Materials and Supplies Credit: the TAXPAYER's own classroom materials expenses as an eligible K-12 educator (900+ hours) — capped at $500 per educator, not $1,000 per return | |
| ksMedicalExpenses | No | KS Schedule A line 1: medical and dental expenses paid (federal Schedule A line 1, or the total if not itemizing federally) — the composer applies the 7.5%-of-federal-AGI floor | |
| mdBusinessCredits | No | MD line 25: business tax credits (Form 500CR — e-file only; transcribed) | |
| mdFederalItemized | No | MD line 17a: total federal itemized deductions (federal Schedule A line 17) | |
| mdInterestCharges | No | MD line 51: Form 502UP interest / late-filing interest | |
| mdSsRrBenefitsYou | No | primary taxpayer's TOTAL Social Security + Railroad Retirement benefits (taxable or not) — reduces the $41,200 cap in the primary's 13A column | |
| meCreditRecapture | No | ME line 20a: tax credit recapture amounts | |
| meDisabledVeteran | No | ME Schedule PTFC/STFC line 14: you or your spouse are rated 100% permanently and totally disabled by the VA — the credit doubles | |
| meFederalItemized | No | ME line 17: the filer itemized on the federal return — Schedule 2 is computed and the LARGER of it and the standard deduction is used (pass meFederalItemizedDeductions and the Schedule 2 amounts) | |
| mePropertyTaxPaid | No | ME Schedule PTFC/STFC line 4: property tax paid in 2025 on the Maine principal residence (house and up to 10 acres) | |
| meUseRateSchedule | No | ME line 20: compute from the rate schedule at the exact income instead of the tax table (the table's $100-row midpoint applies under $100,000 by default) | |
| meUseTaxPurchases | No | ME line 30: purchases for use in Maine on which no sales tax was paid (5.5%) | |
| meUtilitiesAmount | No | ME Schedule PTFC/STFC line 5c: the known amount of heat/utilities/furniture in the rent (omit if unknown → 15% of the rent) | |
| mnPenaltyInterest | No | M1 line 28: late-filing/late-payment penalty and interest (agent-computed per the instructions) | |
| moAdditionsSpouse | No | MO-A Part 1 line 7S: the spouse's additions | |
| moFederalItemized | No | MO-A Part 2 line 1: total federal itemized deductions (federal Schedule A total) plus any approved cultural contributions (literary/musical/scholastic/artistic donations, § 143.141) | |
| moOtherDeductions | No | MO-1040 lines 21-24 bucket: beginning farmer, transport facility, foster parent deductions (agent-transcribed) | |
| moSubtractionsYou | No | MO-A subtractions for the primary EXCLUDING the composer-computed capital gain (line 18) and business income deduction (line 17): exempt federal-obligation interest, state refund, military retirement (100%), railroad retirement, 529/ABLE contributions ($8,000/taxpayer), qualified health insurance premiums, depreciation adjustments, agriculture disaster relief | |
| mtOccupied6Months | No | Schedule 2EC: the claimant occupied a Montana residence as owner, renter or lessee at least six months during the year | |
| ncMedicalExpenses | No | NC Schedule A line 7a: medical/dental expenses BEFORE the floor — the composer subtracts 7.5% of federal AGI | |
| ncRealEstateTaxes | No | NC Schedule A: real estate property taxes (NC allows NO income/sales tax deduction) — inside the $20,000 combined cap | |
| ndUseRateSchedule | No | Form ND-1 line 20: apply the rate schedule at the exact taxable income instead of the printed Tax Table. Below $100,000 the table is MANDATORY by section 57-38-30.3(10); at $100,000 or more the schedule applies anyway | |
| neFederalItemized | No | NE lines 7-10: the filer itemized on the federal return — Nebraska then allows the LARGER of its standard deduction and federal itemized deductions minus state and local income taxes (pass neFederalItemizedDeductions and neSaltIncomeTaxes). A federal standard-deduction filer must use the Nebraska standard deduction | |
| neFederalOtherTax | No | NE line 16c: federal Form 4972 lump-sum tax plus federal Form 5329 early-distribution tax (the lesser of Form 5329 or Schedule 2 line 8) — Nebraska adds 29.6% | |
| neLocalUseTaxRate | No | NE line 58: your local sales and use tax rate in percent from the codes schedule (0.5, 1, 1.5, 1.75, or 2); omit for none | |
| neSaltIncomeTaxes | No | NE line 8: state and local INCOME taxes on federal Schedule A line 5a (before the federal cap); $0 if line 5a is general sales taxes | |
| neUseTaxPurchases | No | NE line 58: 2025 taxable purchases on which no Nebraska sales tax was collected (Internet / out-of-state) — 5.5% state plus the local rate | |
| neWithholding1099 | No | NE line 37: Nebraska income tax withheld on W-2G, 1099-R, 1099-MISC, 1099-NEC (W-2 withholding goes in stateWithholding → line 36) | |
| njAlimonyReceived | No | NJ-1040 line 25 alimony received (NJ did not adopt the TCJA repeal — still NJ income) | |
| njDomesticPartner | No | registered NJ domestic partner claimed as a line 6 regular exemption (+$1,000) | |
| njMedicalExpenses | No | unreimbursed medical expenses (Worksheet F line 1) — the composer applies the 2%-of-line-29 floor | |
| njPensionEligible | No | line 28a gate: filer (or spouse if joint) was 62+ OR blind/disabled per Social Security guidelines on the last day of the year — enables the pension exclusion (us.nj.pension_exclusion) | |
| njTaxableInterest | No | NJ-1040 line 16a taxable interest (NJ-exempt: federal obligations, NJ municipal bonds — exclude here, report on 16b) | |
| nmFederalItemized | No | NM PIT-1 box 12a: the filer itemized on the federal return — triggers the line 10 state and local tax add-back (pass nmSaltIncomeTaxes / nmSaltTotal / nmSaltAllowed / nmFederalStandardDeduction) | |
| nmMedicalExpenses | No | NM: unreimbursed medical care expenses paid (§ 7-2-5.9 definition) — $28,000 or more with a 65+ taxpayer gives the PIT-ADJ line 18 $3,000 exemption and the PIT-RC line 23 $2,800 refundable credit | |
| nmSaltIncomeTaxes | No | NM line 10 worksheet line 1: federal Schedule A line 5a (state and local income taxes, or sales taxes, claimed) | |
| nyHouseholdCredit | No | NYS household credit from table 2 (us.ny.parameters citation) | |
| ohInterestPenalty | No | IT 1040 line 11 interest penalty on underpayment of estimated tax (Ohio IT/SD 2210) | |
| okBlindExemptions | No | count of legally-blind boxes (taxpayer/spouse) — $1,000 each, added to the shared `exemptions` count (self + spouse + dependents) | |
| okFederalItemized | No | taxpayer ITEMIZED on the federal return — Oklahoma then REQUIRES Oklahoma itemized deductions (Schedule 511-D) even if smaller than the standard deduction; a federal standard-deduction filer must take the Oklahoma standard deduction | |
| okPropertyTaxPaid | No | Form 538-H line 15: 2025 real estate (ad valorem) taxes paid on the homestead (no personal property taxes) — credit = amount over 1% of gross household income, max $200 | |
| okStrHasDependent | No | filer can claim a dependent — raises the sales tax relief gross household income limit from $20,000 to $50,000 | |
| orKidsLossAddback | No | Kids Credit worksheet Part B: federal losses + OR-ASC loss-subtraction codes beyond the $20,000 allowance, plus ALL excluded foreign earned income — added back to qualifying income | |
| paNrk1Withholding | No | PA-40 line 17: nonresident tax withheld from PA Schedule(s) NRK-1 | |
| refundableCredits | No | state refundable credits, e.g. the NY credit block: ESCC + NYS EIC + IT-216 + NYC EIC + NYC school tax + NYC child care (WITHOUT their own oracle target, self-computed per the us.ny.parameters citation and disclosed) PLUS us.ny.it214 (the Real Property Tax Credit, which DOES have an oracle target as of TY2025 v5 — pass its computed answer here, not a hand-derived percentage of rent) | |
| riAge65OrDisabled | No | Form RI-1040H Part 1 question D: you or your spouse were 65 or older and/or disabled (receiving Social Security disability) as of December 31, 2025 — required for the property tax relief credit (unattested → not claimed) | |
| riCreditRecapture | No | RI-1040 line 10b: recapture of prior year other Rhode Island credits, from RI Schedule CR line 12 | |
| riHouseholdIncome | No | Form RI-1040H Part 5 line 32: TOTAL household income of ALL persons in the household — taxable AND non-taxable (gross Social Security and pensions, cash public assistance, workers' compensation, unemployment), with rental/business/capital losses added back. This is NOT federal AGI. Must be $40,730 or less for 2025 | |
| riLeadPaintCredit | No | RI-1040 line 14e: residential lead abatement credit from Form RI-6238 line 7 (max $5,000 per unit for removal/abatement, $1,500 for reduction/mitigation, up to three units). Refundable, but rationed against a $250,000 statewide annual fund — the amount received may be prorated | |
| riPropertyTaxPaid | No | Form RI-1040H line 2: property taxes paid or payable for 2025 on the homestead (homeowners, Part 3) | |
| riUseRateSchedule | No | RI line 8: compute with the Tax Computation Worksheet arithmetic at the exact taxable income instead of the Tax Table (taxable income under $100,000 uses the table's $50-row midpoint by instruction; $100,000 or more always uses the worksheet) | |
| riUseTaxPurchases | No | RI Schedule U line 1: total price of purchases subject to the 7% use tax (the actual method) | |
| scSubsistenceDays | No | SC line s: days as a full-time federal/state/local law enforcement officer, firefighter, or EMS worker — $16/day subsistence allowance | |
| vaItemizedMedical | No | VA Sch A line 1: total medical/dental expenses BEFORE any floor (VA applies its own 10%-of-FAGI floor — Virginia deconforms from the federal 7.5% floor) | |
| vtUseRateSchedule | No | Form IN-111 line 8: apply the rate schedule at the exact taxable income instead of the printed Tax Table (mandatory below $75,000: 'TAXABLE INCOME UNDER $75,000 USE THE TAX TABLES') | |
| wiFederalEicForWi | No | the federal EIC AS COMPUTED UNDER WISCONSIN'S IRC (Schedule I Part III recomputation when Part I adjustments exist) — defaults to the shared federalEITC when omitted | |
| wiHomesteadCredit | No | Form 1 line 33: homestead credit (Schedule H/H-EZ circuit breaker, agent-computed, refundable) | |
| wiRepaymentCredit | No | Form 1 line 32: repayment of income previously taxed credit | |
| wvPropertyTaxPaid | No | WV Schedule HEPTC-1 line 1: West Virginia property tax paid on the owner-occupied home in 2025 (after discount, before interest; Class 2 receipt required) | |
| wvUseRateSchedule | No | WV line 8: compute from the Rate Schedule at the exact income instead of the printed Tax Table (single/HOH/MFJ/widow(er) under $100,000 use the table by instruction; MFS and $100,000+ always use the schedule) | |
| wvUseTaxPurchases | No | WV line 13 / Schedule UT line 1: purchases subject to the 6% state use tax on which no sales tax was paid (net of credit for sales tax paid elsewhere) | |
| alCampaignCheckoff | No | Form 40 line 20: $1/$2 Alabama Democratic/Republican party checkoffs — these ADD to the tax due (not fund-neutral like the federal checkoff) | |
| arOtherStateIncome | No | AR1000TC line 2: the other state's income included on this return — the composer approximates the three-step method by recomputing the line 29 tax with this removed from line 28 (or line 25 on the low-income table); status 4 takes it from the primary's column | |
| arTuitionDeduction | No | AR3 line 19: post-secondary education tuition deduction from AR1075 | |
| claimedAsDependent | No | someone else can claim this taxpayer as a dependent (carry the prior-year 1040 'Someone can claim: You as a dependent' checkbox forward as a continuing condition unless the current-year interview contradicts it). IL: zeroes the line 10 exemption allowance when base income exceeds the exemption amount. VA: limits the standard deduction to earned income. | |
| ctIraDistributions | No | Form 1040 line 4b taxable IRA distributions other than Roth — 75% (TY2025) / 100% (TY2026) enters the pension and annuity subtraction | |
| ctPropertyTaxAuto1 | No | CT Schedule 3 line 61: property tax paid on one privately owned or leased (term over one year) motor vehicle | |
| ctPropertyTaxAuto2 | No | CT Schedule 3 line 62: a second vehicle — MFJ / QSS ONLY (the composer ignores it for other statuses with a note) | |
| deCombinedSeparate | No | Delaware FILING STATUS 4, 'Married & Filing Combined Separate on this form' — two separate returns combined on one form. Column A is the spouse, column B the taxpayer, and each column takes its own $3,250 standard deduction and its own trip through the brackets. Pass filingStatus 'mfs' alongside this, and supply the deSpouse* column-A inputs | |
| deOtherStateIncome | No | Other-state credit worksheet line 1: adjusted gross income from the other state's return. The ratio to Delaware AGI is capped at 100%. More than one state uses DE Schedule I, highest credit first | |
| deSpouseExemptions | No | COLUMN A: federal exemptions allocated to the spouse. The instructions require status 4 filers to split the total between columns "in increments of $110" | |
| deSpouseFederalAgi | No | COLUMN A (filing status 4): the spouse's own federal adjusted gross income, including one half of income from jointly titled securities, bank accounts and real estate (the printed Line 1 Worksheet). REQUIRED when deCombinedSeparate is set | |
| gaOtherStateCredit | No | Form 500 line 18: other state(s) tax credit (printed worksheet, hand-computed; other-state return copy required) | |
| gaOtherWithholding | No | Form 500 line 25: GA tax withheld on G2-A / G2-FL / G2-LP / G2-RP statements (never W-2/1099 amounts — those go in the shared stateWithholding for line 24) | |
| gaRetirementIncome | No | primary taxpayer's UNEARNED retirement income for the exclusion (pensions, interest, dividends, net rents, capital gains, royalties, military retirement; joint property at 50%; NEVER Social Security — that subtracts automatically) | |
| hiOutOfStateIncome | No | HI other-state worksheet line 3: out-of-state income including capital gains (not Hawaii-exempt income such as employer-funded pensions) | |
| hiPensionExclusion | No | HI line 13: pension distributions taxed federally but not by Hawaii — employer-funded plans (public retirement systems, military pensions, private plans the employee did not contribute to; Schedule J for hybrid plans) | |
| hiSpouseFederalAgi | No | HI Form N-311 line 5 (married filing separately): the spouse's federal AGI, added for the credit table | |
| hiSpouseReservePay | No | HI line 15: the spouse's reserve / National Guard duty pay on a joint return (its own $8,636) | |
| idAdoptionExpenses | No | ID Form 39R Part B line 12: legal and medical adoption expenses — the composer caps at $10,000 per adoption (pass the per-adoption total) | |
| idDonateFoodCredit | No | ID line 43: donate the entire Food Tax Credit to the Cooperative Welfare Fund (line 43 = $0) | |
| idForeignTaxCredit | No | ID: federal foreign tax credit claimed — Idaho adds it to itemized deductions (no matching credit) | |
| idOtherStateIncome | No | ID Form 39R Part C line 2: federal AGI earned in the other state and taxed by both states, adjusted for Idaho modifications | |
| idOtherStateTaxDue | No | ID Form 39R Part C line 6: the other state's tax due minus its income tax credits (not withholding; not SALT workaround payments) — attach that return | |
| idRailroadBenefits | No | ID Form 39R line 8b: federal Railroad Retirement benefits received (RRB-1099 Box 5, RRB-1099-R Box 7 less Box 8) | |
| idSchAOtherMedical | No | ID health/LTC worksheet line 3: other medical expenses on federal Schedule A | |
| ks529Beneficiaries | No | number of 529 beneficiaries contributed for (caps line A16 at $3,000/$6,000 each); defaults to 1 when contributions are given | |
| ks529Contributions | No | KS Schedule S line A16: contributions to Learning Quest / Quest529 / Schwab 529 or another state's 529 plan — the composer caps at $3,000 per beneficiary ($6,000 MFJ) using ks529Beneficiaries | |
| ksDisabledVeterans | No | taxpayer and/or spouse honorably discharged and VA-certified 100% permanently disabled — additional $2,320 exemption each | |
| ksExemptRetirement | No | KS Schedule S line A14: retirement benefits exempt from Kansas tax included in federal AGI — KPERS, Kansas Police & Fire, Kansas teachers' annuities, federal civil service and MILITARY retirement (incl. TSP), Railroad Retirement, Highway Patrol, judges, Board of Public Utilities, Regents annuity contracts, Washburn, Overland Park police/fire (NOT Social Security — automatic via taxableSocialSecurity) | |
| ksMortgageInterest | No | KS Schedule A line 9: qualified residence interest and points (100%) | |
| ksOtherStateIncome | No | KS line 13 worksheet line 3: total income from the other state included in Kansas AGI — the credit is limited to Kansas tax × (this ÷ KAGI) | |
| mdHomebuyerPenalty | No | MD line 51a: first-time homebuyer savings account 10% withdrawal penalty | |
| mdRecapturedCredit | No | MD line 21a: recaptured credit from Form 502CR Part DD line 1 | |
| me529Beneficiaries | No | ME Schedule 1S line 8: number of 529 beneficiaries (defaults to 1) | |
| me529Contributions | No | ME Schedule 1S line 8: contributions to 529 plans — the composer caps at $1,000 per beneficiary (me529Beneficiaries) and allows it only when federal AGI is not over $100,000 single/MFS or $200,000 otherwise | |
| meMedicalDeduction | No | ME Schedule 2 line 2d: medical and dental expenses deducted (Schedule A line 4) — removed from the $36,300-capped total and added back uncapped | |
| moOtherTaxesSpouse | No | MO-1040 line 34S | |
| moPublicPensionYou | No | the primary's PUBLIC-source pension (federal/state/local government, 1040 line 5b share) — the composer runs MO-A Part 3 Section A (min(pension, $47,633) less their Section C exemption). Military retirement goes in moSubtractionsYou instead (100%, MO-A line 10). | |
| ncBaileyRetirement | No | NC Schedule S line 20: Bailey settlement retirement benefits (NC/local government or US government incl. military retirees with 5+ years of creditable service as of Aug 12, 1989; state 401(k)/457 contributed before that date) — fully deducted; enclose the 1099-R | |
| ncMortgageInterest | No | NC Schedule A: qualified mortgage interest — the composer applies the $20,000 combined cap with real estate taxes and takes itemized only when it beats the standard deduction | |
| neWildlifeDonation | No | NE line 62: Wildlife Conservation Fund donation from the overpayment ($1 or more) | |
| njEitcAgeDecoupled | No | flat-$260 NJEITC attested: 18+, no qualifying child, met all federal EIC requirements except age, not claimed as a dependent (NJ eliminated both federal age limits) | |
| njSpecialExclusion | No | line 28b Special Exclusion attested: filer (and spouse if joint) will NEVER be eligible for Social Security/Railroad Retirement because the employer did not participate — adds $6,000 (MFJ/HOH/QSS) / $3,000 (single/MFS) | |
| nmBusinessSaleGain | No | NM PIT-ADJ line 16: net capital gain from the sale of a New Mexico-apportioned business — 40% of up to $1,000,000 deducted if larger | |
| nmFederalDeduction | No | NM PIT-1 line 12: the federal standard or itemized deduction from Form 1040 line 12 — REQUIRED (New Mexico taxable income subtracts the federal deduction; § 7-2-2(N)) | |
| nycHouseholdCredit | No | NYC household credit from table 5 | |
| ohRetirementIncome | No | retirement income received on account of retirement still INCLUDED in Ohio AGI, both spouses combined (NOT Social Security/railroad/uniformed-services amounts — those are deducted and never qualify) — drives the retirement income credit (max $200) | |
| ok529Contributions | No | OK Schedule 511-C line 3: Oklahoma 529 College Savings Plan / OklahomaDream 529 contributions (incl. carryforwards and contributions through April 15) — the composer caps at $10,000 ($20,000 joint) | |
| okGovRetirementYou | No | OK Schedule 511-A line 5, TAXPAYER: Oklahoma-government / U.S. civil service retirement in the taxpayer's own name (OPERS, TRS, police, fire, judges, county/municipal systems) — excluded up to $10,000 per person (us.ok.retirement_exclusion) | |
| okHomeschoolCredit | No | OK line 29: Parental Choice Tax Credit for homeschool expenses from Form 591-D (refundable) — the composer caps at $1,000 × okHomeschoolStudents when the count is given | |
| okOtherAdjustments | No | OK Schedule 511-C lines 2, 4-6 total: disability modification expenses, foster care (≤ $5,000), Parental Choice payments, and the misc codes (MSA/HSA, ag processing, organ donation ≤ $10,000, poll-worker leave, homebuyer savings $5,000/$10,000, ABLE $10,000/$20,000, etc.) — transcribed | |
| okOtherStateCredit | No | OK line 16: Form 511-TX credit for tax paid to another state on PERSONAL-SERVICES income (agent-computed per the form's proportion; capped at the remaining tax by the composer) | |
| okOutOfStateIncome | No | OK Form 511 line 4: income from real or tangible personal property or BUSINESS activity in another state (partnership/S-corp shares included) — NEVER wages, interest, dividends, pensions, unemployment, or gambling. When > 0 the composer prorates deductions and exemptions on Schedule 511-E and leaves lines 10-11 blank. | |
| or2024TaxLiability | No | the filer's 2024 total Oregon personal income tax liability (after the other-state credit, before all other credits/payments — 2024 OR-40 line 24 tax-before-credits MINUS the Schedule OR-ASC code 802/815 credit for taxes paid to another state, per Table 8 / Kicker worksheet Part A) — the composer computes the 9.863% kicker (us.or.kicker). Requires the 2024 return filed before the 2025 return. Prorate by 2024 Oregon-AGI share if the filing status changed (worksheet Parts B/C). | |
| orCreditRecaptures | No | OR-40 line 22: tax recaptures from Schedule OR-ASC line C5 | |
| orKidsObbbaAddback | No | Kids Credit worksheet line 2: tips/overtime/vehicle-interest subtractions claimed (OR-ASC codes 390/391/392) — ADDED BACK to qualifying income | |
| pa529Contributions | No | Schedule O code T: § 529 contributions, ALREADY capped at $19,000 per beneficiary per taxpayer-spouse (2025); no deduction for rollovers/beneficiary changes | |
| paScheduleDcCredit | No | PA-40 line 23 component: the Child and Dependent Care Enhancement credit — pass us.pa.cdcc's computed answer (= 100% of the federal Form 2441 line 9a tentative credit; refundable) | |
| riHouseholdMembers | No | Form RI-1040H line 1f: number of persons in the household — selects the '1 person' or '2 or more' column of the computation table (they differ only in the $13,971-$17,460 band). Defaults to 1 | |
| riOtherStateIncome | No | RI Schedule II line 24: income derived from the other state, determined as it would be for federal purposes. More than one state uses Form RI-1040MU (sum the line 29 amounts) | |
| scDependentsUnder6 | No | SC line t: dependents under age 6 on December 31 — the SAME $4,930 again each (on top of their line w exemption) | |
| scOtherWithholding | No | SC1040 line 20: other SC withholding from 1099s (W-2 amounts go in the shared stateWithholding for line 16) | |
| vaItemizedCasualty | No | VA Sch A casualty/theft losses (protected from the overall limitation) | |
| vaItemizedGambling | No | VA Sch A gambling losses (§ 165(d), limited to winnings; protected from the overall limitation) | |
| vtOtherStateIncome | No | Schedule IN-117 line 9: modified AGI taxed by the other state or Canadian province AND by Vermont (the AGI taxed there, adjusted for its bonus depreciation, non-Vermont obligation and U.S. interest items); one schedule per state, pass the sum | |
| wiOtherStateCredit | No | Form 1 line 20: net income tax paid to another state (Schedule OS, agent-computed) | |
| wiRentHeatIncluded | No | 2025 rent on the principal Wisconsin residence with heat INCLUDED (line 16a; 2.4% via the printed table's $100-row midpoints) | |
| wvOtherStateIncome | No | WV Schedule E line 3: net income derived from the other state included in West Virginia total income | |
| wvSpouseUsInterest | No | WV Schedule M line 29 column B (spouse) | |
| yonkersWithholding | No | NY line 74 Yonkers withholding (W-2 box 19 with a Yonkers locality) | |
| alAppliedToNextYear | No | Form 40 line 33: overpayment applied to 2026 estimated tax | |
| alInterestDividends | No | Form 40 line 6: interest and dividend income (Schedule B attached if over $1,500) | |
| arChildCareExpenses | No | AR2441 line 3 base: qualified child and dependent care expenses paid (capped at $3,000 / $6,000 by arChildCareQualifyingPersons); the credit is 20% of the 2013-law federal computation — requires federalAGI (AR2441 line 7) | |
| arOtherStateTaxPaid | No | AR1000TC line 2: income tax actually paid to another state on income also taxed by Arkansas (attach that state's signed return) — credit is the LESSER of this or the Arkansas tax on that income | |
| arSpouseAdjustments | No | AR status 4 column B: the spouse's share of the AR1000ADJ adjustments (line 24B); column A gets arAdjustments minus this | |
| arUseLowIncomeTable | No | AR line 26: force the Low Income Tax Table (true; statuses 1, 2, 3, 6 within the income limits, no itemizing — the retirement/military exclusions are then NOT used) or the Regular Income Tax Table (false). Omit to let the composer take the LOWER net tax | |
| ctAbleContributions | No | CT Schedule 1 line 48d: contributions to ABLE accounts — the composer caps at $5,000 ($10,000 MFJ/QSS) | |
| ctAppliedToNextYear | No | CT-1040 line 23: overpayment applied to 2026 estimated tax (irrevocable) | |
| ctChetContributions | No | CT Schedule 1 line 48: contributions to Connecticut Higher Education Trust (CHET) 529 accounts made during the year plus allowed carryforward — the composer caps at $5,000 ($10,000 MFJ/QSS); the excess carries forward five years | |
| deOtherStateTaxPaid | No | Other-state credit worksheet line 6: income tax paid to the other state net of its credits. EXCLUDES city and county taxes; the District of Columbia counts as a state | |
| deSpouseAge60OrOver | No | COLUMN A: the spouse was 60 or over on December 31 — the 60-or-over pension tier | |
| gaMilitaryExclusion | No | GA military retirement exclusion for under-62 retirees (Schedule 1 page 3 worksheet: $17,500 + additional $17,500 when GA earned income exceeds $17,500 — hand-computed, per qualifying spouse) | |
| hiChildCareExpenses | No | HI Schedule X line 20/22: qualified child and dependent care expenses paid in 2025 (a child under 13 or a disabled dependent/spouse; A+ Program payments qualify) | |
| hiEitcCarryover2022 | No | HI Schedule CR line 24 column (c): the 2022 nonrefundable EITC carryover applied this year (Form N-356 Part III; last usable in 2025) | |
| hiFundContributions | No | HI lines 43a-43c: contributions from the overpayment to the Hawaii schools repairs ($2 / $4 joint), public libraries ($5 / $10), and domestic violence / child abuse ($5 / $10) funds — the total | |
| hiRentersExemptions | No | HI Schedule X line 11 override: qualified persons present more than nine months plus 1 for you and 1 for your spouse if 65 or older — defaults to the line 6e count | |
| idChildCareExpenses | No | ID Form 39R Part B line 6: qualified child/dependent care expenses paid (deduction ≤ $12,000 less excluded benefits, ≤ each spouse's earned income; pass idEarnedIncome) | |
| idHomeFamilyMembers | No | ID Form 39R Part E / Part B line 15: family members age 65+ (not you or your spouse) or with a developmental disability for whom you maintained a home all year and provided over half the support — $100 credit each (max $300), or the $1,000 deduction each (max 3) with idHomeFamilyDeduction | |
| idIdahoNolCarryover | No | ID Form 39R Part B line 1: Idaho net operating loss carryover/carryback (Form 56) | |
| ksFederalLumpSumTax | No | KS line 11: the FEDERAL tax on a lump-sum distribution from Form 4972 — Kansas tax is 13% of it (residents; KPERS lump sums prorated by the agent) | |
| ksOtherStateTaxPaid | No | KS line 13 worksheet line 1: 2025 income tax actually paid to ONE other state (incl. its localities) — not the amount withheld; enclose that state's return | |
| mdChildCareExpenses | No | MD line 9: child and dependent care EXPENSES from federal Form 2441 line 6 — an income subtraction in Maryland (separate from any 502CR Part B credit); the composer caps it at $3,000 ($6,000 when mdChildCareTwoOrMoreDependents) | |
| meAdultCareExpenses | No | ME adult dependent care credit: adult day care, hospice, and respite expenses for a disabled adult dependent (not used for the federal credit) — 25% × the federal percentage, up to $500 refundable | |
| meChildCareExpenses | No | ME child care worksheet line 1: total expenses on Form 2441 line 2(d) | |
| meExemptIncomeCosts | No | ME Schedule 2 line 2b: costs of producing Maine-exempt income | |
| meRealEstateTaxes5b | No | ME Schedule 2 line 3b: real estate taxes (Schedule A line 5b) — added back | |
| meSpouseNoIncomeMfs | No | ME line 13 (married filing separately): your spouse had no federal gross income and you would claim a federal personal exemption for them — 2 exemptions | |
| meStudentLoanCredit | No | ME Schedule A line 5: Student Loan Repayment Tax Credit from its worksheet (≤ $2,500, refundable) | |
| mnAppliedToNextYear | No | M1 line 30: refund applied to 2026 estimated tax | |
| mnMfsSpouseItemizes | No | MFS only: the other spouse claims Minnesota itemized deductions — bars the standard deduction (the composer then requires mnItemized) | |
| moAppliedToNextYear | No | MO-1040 line 50: overpayment applied to 2026 estimated tax | |
| moBusinessIncomeYou | No | the primary's MISSOURI-SOURCE net business income per the p.16 worksheet (Schedule C line 31 + Schedule E line 32 + Schedule F/4835 profits, losses netted, MINUS agricultural disaster relief payments already on MO-A line 16; $0 if net loss) — the composer takes the 20% § 143.022 deduction (MO-A line 17Y) | |
| moCapitalGainSpouse | No | the spouse's share of federal capital gains for the 100% subtraction | |
| moEnterpriseZoneYou | No | MO-1040 line 28Y: enterprise zone / rural empowerment zone income modification | |
| moOtherFederalTax10 | No | MO-1040 line 10 'Other federal tax': Schedule 2 Part 1 line 3 + Part 2 lines 8/14/15 + recapture in line 21 + Schedule 3 Part 1 line 1 (attach 4255/8611/8828 for recapture) | |
| moPayrollTaxAddback | No | MO-A Part 2 lines 2-7 total: the 2025 employee Social Security tax (capped $10,918 per spouse), Railroad Retirement Tier I+II (capped $17,327 per spouse, net of employer refunds), Medicare tax (with Form 8959 adjustments), and self-employment tax (Schedule 2 line 4 − Schedule 1 line 15 + Form 8959 line 13) — Missouri ADDS payroll taxes into itemized deductions | |
| moPrivatePensionYou | No | the primary's PRIVATE-source taxable pension/annuity/IRA/401(k) (1040 lines 4b+5b share) — Section B caps each spouse at $6,000 and phases out by income | |
| moPropertyTaxCredit | No | MO-1040 line 43: Form MO-PTS property tax credit (refundable circuit breaker — actual property tax up to $1,100 owners / 20%-of-rent up to $750 renters, from the printed chart; net household income gates $30,000 owners / $27,200 renters; agent-computed from MO-PTS with disclosure) | |
| moRequiredToItemize | No | the filer was REQUIRED to itemize federally (e.g. MFS with an itemizing spouse) — Missouri then requires itemizing even when the standard deduction is larger | |
| moResidentCreditYou | No | MO-1040 line 31Y: Form MO-CR credit for taxes paid to other states (agent-computed; the composer caps at line 30Y) | |
| mtAbleContributions | No | Schedule I line 17: contributions to an ABLE account — capped at $3,000, or $6,000 on a JOINT return. Not inflation-indexed | |
| mtAppliedToNextYear | No | Form 2 line 24: amount of the overpayment applied to 2026 estimated taxes | |
| mtFederalDeductions | No | REQUIRED for Montana. Form 2 line 2: the total of federal Form 1040 lines 12e and 13b — the federal standard OR itemized deduction plus the Schedule 1-A deductions (qualified tips, qualified overtime, passenger vehicle loan interest, the enhanced senior deduction). Montana has NO standard deduction of its own, so this is the only deduction. Do NOT include the federal qualified business income deduction — § 15-30-2120(2)(i) adds it back | |
| mtOtherStateTaxPaid | No | Schedule III Part II lines 4 AND 14: the TOTAL income tax liability actually paid to the other state or country, excluding penalties and interest — the same figure feeds both blocks; the line 16 ratio attributes the capital-gains share. North Dakota WAGES are not eligible (reciprocity — file an ND return for a refund); foreign tax is ineligible if a federal Form 1116 credit was claimed | |
| mtPropertyTaxBilled | No | Schedule 2EC line 23: property tax billed on the Montana residence and up to one acre, including special assessments and fees but excluding penalties and interest | |
| ndAppliedToNextYear | No | Form ND-1 line 30: the amount of the line 29 overpayment to apply to 2026 estimated tax | |
| ndDoublyTaxedIncome | No | Schedule ND-1CR line 1c: the part of federal AGI sourced to the other state that was received or earned while a North Dakota resident | |
| ndOtherStateTaxPaid | No | Schedule ND-1CR line 6: the NET income tax on the other state's return — after that state's credits but before its withholding and estimated payments — plus local jurisdiction tax in that same state. A separate Schedule ND-1CR is required per state. Montana and Minnesota WAGES are excluded by reciprocity; foreign country tax never qualifies | |
| neChildCareExpenses | No | NE Form 2441N line 3 base (AGI $29,000 or less): qualified child/dependent care expenses paid, capped at $3,000 / $6,000 by neChildCareQualifyingPersons | |
| neNestContributions | No | NE Schedule I line 20: contributions by the account owner to Nebraska Educational Savings Plan Trust (NEST / Bloomwell / State Farm 529) accounts — the composer caps at $10,000 ($5,000 MFS) | |
| neOtherStateTaxPaid | No | NE Schedule II line 5: income tax due and paid to the other state (or its political subdivision) — not withholding; no foreign taxes; attach the other state's complete return | |
| neStillbornChildren | No | NE line 47: stillborn children (20+ weeks, Nebraska certificate attached) — $2,000 each, refundable | |
| njCollegeDependents | No | line 12 count: dependents under 22 attending college full-time (five months, half support) — $1,000 each ON TOP of the $1,500 line 10/11 exemption (use the shared dependents input for the $1,500 count) | |
| njPensionExcludable | No | NJ-1040 line 20b excludable (previously-taxed) pension/annuity/IRA amounts — display only | |
| njPropertyTaxesPaid | No | NJ-1040 line 40a: property taxes due and paid on the principal residence (homeowners; after Worksheet G proration). Tenants: use njRentPaid instead and the composer applies the 18% conversion. | |
| njSeHealthInsurance | No | self-employed health insurance deduction (Worksheet F line 5) | |
| njTaxExemptInterest | No | NJ-1040 line 16b tax-exempt interest (reported, never taxed) | |
| nmOilGasWithholding | No | NM PIT-1 line 28: New Mexico tax withheld from oil and gas proceeds (1099-MISC / RPD-41285) | |
| nmPropertyTaxBilled | No | NM PIT-RC lines 15 / 18a: property tax billed for 2025 on the owned principal residence | |
| ohNonresidentCredit | No | OH Schedule of Credits line 38 nonresident credit (Ohio IT NRC, hand-computed) | |
| okAppliedToNextYear | No | OK line 35: overpayment applied to 2026 estimated tax (original return only) | |
| orAppliedToNextYear | No | OR-40 line 48: refund applied to 2026 estimated tax | |
| orFederal1040Line22 | No | federal Form 1040 LINE 22 (tax after nonrefundable credits) — the federal tax subtraction worksheet's line 1 (from compute_return, verbatim) | |
| orRegularExemptions | No | regular exemption count: 'yourself' + 'spouse' credit boxes (6a/6b) + dependents (6c) — $256 each, $0 cliff above $100,000 federal AGI (single/MFS) or $200,000 (others) | |
| orTaxMethodOverride | No | OR-40 line 20 alternate-method tax: farm income averaging (OR-FIA-40, box 20a), farm capital gain (Worksheet FCG, box 20b), or the IRREVOCABLE Oregon PTE reduced rate (OR-PTE-FY, box 20c) — agent-computed; wins over the table/chart tax | |
| paAbleContributions | No | Schedule O code A: PA ABLE contributions, capped at the federal gift-tax exclusion ($19,000 for 2025) | |
| paGrossCompensation | No | PA-40 line 1a: W-2 BOX 16 total (NOT Box 1 — 401(k)/elective deferrals are PA-taxable; eligible retirement distributions are exempt and excluded). Falls back to the shared wages input when omitted (composer discloses). Include taxable early-distribution amounts under the cost-recovery method. | |
| paPenaltiesInterest | No | PA-40 line 27: penalties and interest incl. estimated-underpayment penalty (REV-1630) | |
| paScheduleOcCredits | No | PA-40 line 23 component: Schedule OC restricted credits total (transcribed; no oracle target) | |
| paSpouseBusinessNet | No | PA-40 line 4, SPOUSE's own net business income or loss (kept separate: PA never nets one spouse's loss against the other's income) | |
| paSpousePropertyNet | No | PA-40 line 5, spouse's own net property gain/loss | |
| riAppliedToNextYear | No | RI-1040 line 18: amount of the overpayment to apply to 2026 estimated tax (capped at the overpayment remaining after line 15b) | |
| riOtherStateTaxPaid | No | RI Schedule II line 28: income tax actually due and paid to the other state (not the amount withheld — if it was all refunded, enter $0). Attach a copy of the other state's return | |
| riUseTaxLookupTable | No | RI Schedule U: use the § 44-30-100 safe-harbor lookup table (0.08% of federal AGI, or the printed $5-$60 band) instead of actual purchases. Either way the taxpayer must PROACTIVELY check the line 12a attestation box — software may not pre-check it | |
| scAppliedToNextYear | No | SC1040 line 27: amount of the line 24 overpayment credited to 2026 estimated tax | |
| scSubtractionsOther | No | SC subtraction lines f/g/h/j/k/l/m/n/v total (state tax refund, total-and-permanent disability retirement, out-of-state non-personal-service income, volunteer firefighter/EMS/police $6,000 (2025), Future Scholar 529 (unlimited), ACTIVE TRADE OR BUSINESS income electing the I-335 3% flat tax (line l — must pair with scActiveTradeTax), US government interest, nontaxable Guard/Reserve pay, other) — EXCLUDING the composer-computed lines i/o/p/q/r/s/t/u/w | |
| vaAgeQualifyingFull | No | count of filers (taxpayer/spouse) born ON OR BEFORE January 1, 1939 — each gets the UNCONDITIONAL $12,000 age deduction (no income test) | |
| vaYourAgeBlindBoxes | No | STA worksheet Part 1 line 2: PRIMARY taxpayer's 65+/blind box count (0-2) — per-spouse exemption = boxes x $800 + $930 | |
| vtAppliedToNextYear | No | Form IN-111 line 28a: refund to be credited to 2026 estimated tax | |
| vtOtherStateTaxPaid | No | Schedule IN-117 line 20: income tax PAID to the other state or Canadian province — not withholding, not city or county tax, not the part of Canadian tax taken as a federal foreign tax credit | |
| wiAppliedToNextYear | No | Form 1 line 42: overpayment applied to 2026 estimated tax | |
| wiPropertyTaxesPaid | No | property taxes on the principal residence (line 16b; 12% via the printed $25-wide-row table — a different granularity from the $100-row rent tables) — combined 16a+16b credit caps at $300 ($150 MFS or married-HOH); not claimable with the line 34 veterans credit | |
| wiScheduleUInterest | No | Form 1 line 44: Schedule U underpayment interest | |
| wvAbleContributions | No | WV Schedule M line 43: ABLE account contributions | |
| wvJumpstartDeposits | No | WV Schedule M line 44: Jumpstart Savings Program deposits — the composer caps at $25,000 | |
| wvNonWvBondInterest | No | WV Schedule M line 52: interest or dividends on non-West Virginia state and local bonds (added) | |
| alFederalTaxPlusNiit | No | federal Form 1040 LINE 22 tax PLUS Form 8960 line 17 NIIT — the line 12 worksheet's gross federal tax (from compute_return, verbatim; NEVER the W-2 federal withholding) | |
| alItemizedDeductions | No | Alabama Schedule A total — differs from federal: FICA/Medicare/SE taxes ARE deductible, medical floor is 4% of AGI, NO federal income tax here (it's line 12), NEW 2025 vehicle-loan interest ≤$10,000 phased out $200 per $1,000 ceil-step of AGI over $100,000/$200,000-MFJ. The composer takes the larger of this or the AGI-phased standard deduction. | |
| alScheduleCpPayments | No | Form 40 line 26: payments from Schedule CP, Section B line 1 (composite payments) | |
| arSpouseEarnedIncome | No | AR2441 line 5: the spouse's earned income (status 2 or 4; student/disabled deemed amounts per the instructions) | |
| arSpouseLongTermGain | No | AR status 4 column B (AR1000D): the SPOUSE's net long-term capital gain or loss — its own 50% exclusion and $1,500 loss floor; added to the primary's for a status 2 (joint) return | |
| caAb5NetLossAddition | No | net losses from businesses where the worker is an employee for California (intake ca_form540_schca.add_net_loss) — the federal Schedule C loss is disallowed for CA: Schedule CA BUSINESS addition, col C | |
| caItemizedDeductions | No | CA itemized deduction total (Schedule CA Part II, line 29) — agent-computed per Schedule CA's own itemized rules WITH disclosure (differs from the federal Schedule A: no SALT cap, mortgage/medical add-backs, etc.). Form 540 line 18 takes the GREATER of this or the CA standard deduction; omit to use the standard deduction only. | |
| ctClaimOfRightCredit | No | CT-1040 line 20b: claim of right credit from Form CT-1040 CRC line 6 (repayment over $3,000 under IRC § 1341; refundable) | |
| ctMilitaryRetirement | No | CT Schedule 1 line 44: military retirement pay included in federal AGI (retired armed forces / National Guard member or survivor-option beneficiary; NOT a former spouse's court-ordered share) — 100% subtracted; also excluded from ctPensionAnnuityIncome | |
| ctRailroadRetirement | No | CT Schedule 1 line 43: Tier 1 and Tier 2 Railroad Retirement benefits, supplemental annuities, and RRB unemployment/sickness benefits included in federal AGI (excluding any Tier 1 already covered by the line 41 Social Security adjustment) — subtracted; also excluded from ctPensionAnnuityIncome | |
| ctTeachersRetirement | No | CT Schedule 1 line 45: income from the Connecticut Teachers' Retirement System (Form 1099-R from the Teachers' Retirement Board) — the composer subtracts 50%; a teacher under the pension AGI threshold may instead include it in ctPensionAnnuityIncome (never both) | |
| deItemizedDeductions | No | Form PIT-RES line 19: net Delaware itemized deductions from Form PIT-RSA — federal itemized less Delaware income tax and other-state tax taken as a credit, plus foreign taxes paid, the charitable mileage differential and up to $500 of labor organization dues | |
| deSpouseAge60Persons | No | COLUMN A: persons 60 or over counted in the spouse column ($110 each) | |
| deSpouseEarnedIncome | No | COLUMN A: the spouse's earned income for the line 11 test | |
| deSpouseSubtractions | No | COLUMN A: the spouse's other Delaware subtractions (line 7 items) | |
| gaFederalCdccAllowed | No | federal Form 2441 line 11 allowed credit — GA IND-CR 202 pays 50% of it (us.ga.cdcc) | |
| hiInvestmentInterest | No | HI Worksheet A-3 line 13: investment interest (Form N-158) — protected from the overall limitation | |
| hiJobAndMiscExpenses | No | HI Worksheet A-6 lines 23-25: unreimbursed employee business expenses, tax preparation fees, investment expenses — subject to the 2%-of-AGI floor | |
| hiSpouseEarnedIncome | No | HI Schedule X line 24: the spouse's earned income on a joint return (use the $200 / $400 per-month deemed amount for a student or disabled spouse) | |
| hiSpouseExemptionMfs | No | HI line 6b on a married filing separate return: the spouse had no income, is not filing a return, and cannot be claimed as a dependent by another — one $1,144 exemption (plus the age-65 extra) | |
| idHealthPremiumsPaid | No | ID Form 39R Part B line 18: health insurance premiums paid for you, spouse, and dependents, excluding pre-tax/cafeteria-plan and business-deducted premiums (worksheet line 7) | |
| idPenaltyAndInterest | No | ID line 52: penalty and interest (interest 6% for 2026; 10% penalty on a nonqualified Idaho MSA withdrawal under 59½) | |
| idQualifyingChildren | No | ID line 24: qualifying children age 16 or under on December 31, 2025 — $205 nonrefundable each (TY2025 only; § 63-3029L sunsets for 2026) | |
| idRetirementEligible | No | ID Form 39R line 8: the filer (or spouse) meets the § 63-3022A age/disability test — 65, or 62 and disabled; military retirees: disabled, 62+, or employed with income requiring a federal return. Not available MFS | |
| idSchAHealthPremiums | No | ID health/LTC worksheet line 1: health insurance premiums included on federal Schedule A (medical) — only matters when itemizing for Idaho | |
| idSpouseEarnedIncome | No | ID Form 39R child care worksheet line 6: spouse's earned income (MFJ) | |
| idYouthContributions | No | ID Form 39R Part D line 2: donations to Idaho youth/rehabilitation facilities, centers for independent living, or licensed substance abuse centers (50% credit, ≤ 20% of tax, ≤ $100 / $200 joint) | |
| ksAmendedOverpayment | No | KS line 26 (amended return only): overpayment shown on the original return (subtracted) | |
| mdEicQualifyingChild | No | the filer has at least one EIC qualifying child — with married filers this routes line 22 to 50% of the federal EIC (Worksheet 18A) and line 44 to the 45% refundable worksheet (21A); childless single/HOH/QSS filers instead get 100% refundable (18A.1). Also drives the Form 502 EIC checkboxes. | |
| mdSsRrBenefitsSpouse | No | spouse's TOTAL SS/RR benefits for their 13A column | |
| meAmendedOverpayment | No | ME line 26 (amended only): overpayment on the original return | |
| meDependentsUnderSix | No | ME dependent exemption credit: how many of the line 13a dependents were under 6 at the end of 2025 ($610 each instead of $305) | |
| meHasQualifyingChild | No | ME EITC: the filer had at least one qualifying child for the federal EIC (25% of the federal credit; 50% without) | |
| meMilitaryRetirement | No | ME pension worksheet P9: eligible military retirement pay in federal AGI (100% deductible; taxpayer and spouse combined) | |
| meNonMilitaryPension | No | ME Schedule 1S line 4 worksheet P1 (taxpayer): eligible non-military employee retirement plan and IRA benefits in federal AGI (not distributions before 55 outside a periodic series, not Roth conversions) | |
| moActiveDutyMilitary | No | MO-1040 line 18: active duty military income deduction (100%, incl. annual training and — NEW 2025 — National Guard/reserve signing bonuses) | |
| moSubtractionsSpouse | No | the spouse's MO-A subtractions on the same terms | |
| moTrustFundDonations | No | MO-1040 line 51: trust fund donations total (51a-51l) | |
| mtExemptTribalIncome | No | Schedule I line 11: exempt tribal income of an enrolled member living on the reservation of their tribe (Form ETM) | |
| mtLoanOutWithholding | No | Form 2 line 11e: loan-out withholding from Form LOWCERT | |
| ncMilitaryRetirement | No | NC Schedule S line 21: military retirement pay / SBP payments for members with 20+ years of service OR Chapter 61 medical retirement — never severance, never double-claimed with Bailey | |
| ncQualifyingChildren | No | D-400 line 10a: count of qualifying children for whom the federal § 24 child tax credit was ALLOWED (under 17; ODC-only dependents never count) — drives the AGI-tiered child deduction (us.nc.child_deduction) | |
| ndExemptTribalIncome | No | Form ND-1 line 7: exempt income of an enrolled member of a federally recognized tribe who lived on a North Dakota reservation all year (includes the North Dakota portions of Standing Rock and Lake Traverse that lie in South Dakota) | |
| ndMilitaryRetirement | No | Form ND-1 line 14: military retirement benefits, excluded IN FULL with no cap, for the retiree or a surviving spouse, and covering a dual-status military technician's federal civil-service retirement | |
| ndQualifiedDividends | No | Form ND-1 line 13: qualified dividends from federal Form 1040 line 3a — North Dakota excludes 40% | |
| neAmendedOverpayment | No | NE line 54 (amended return only): overpayment allowed on the original return | |
| neMilitaryRetirement | No | NE Schedule I line 32: military retirement benefits in federal AGI (Form 1040 line 5b, DoD or OPM 1099-R) — 100% excluded | |
| neSpouseEarnedIncome | No | NE Form 2441N line 5: the spouse's earned income (MFJ) | |
| nmQualifyingChildren | No | NM PIT-RC line 25: qualifying children (§ 152(c)) — child income tax credit $637 to $26 each by AGI, refundable | |
| nonrefundableCredits | No | state NONREFUNDABLE credits without an oracle target — capped at the state tax due by the composer (an excess never creates a refund). VA: do NOT put the low-income credit or any VA EITC election here — passing it forces a legacy capped path; instead pass federalEITC (+ vaFamilyVagi if testing the low-income credit) and the composer computes and SELECTS the Form 760 line 23 credit itself (TY2025 refundable VA EITC = 20% of federal EIC, uncapped — it dominates whenever federal EITC > 0). IL: pass ICR raw inputs instead where fields exist. | |
| ohFederalCdccAllowed | No | federal Form 2441 line 11 (liability-limited allowed credit) — the Ohio CDCC pays 25% of it when MAGI is $20,000-$39,999 | |
| ohOtherCreditsPreJfc | No | OH Schedule of Credits lines 3+5+7+8 (lump sum retirement, lump sum distribution, displaced worker training, campaign contribution) — transcribed; they subtract BEFORE the joint filing credit's line-11 base | |
| okHomeschoolStudents | No | OK line 29: number of eligible homeschool students claimed (one Form 591-D each) | |
| okMilitaryRetirement | No | OK Schedule 511-A line 4: military retirement benefits included in federal AGI (100% excluded) | |
| okOtherRetirementYou | No | OK Schedule 511-A line 6, TAXPAYER: other qualified plan / IRA / 403(b) / 457 / lump-sum retirement income — the $10,000 per-person cap is shared with line 5 | |
| okRailroadRetirement | No | OK Schedule 511-A line 7: U.S. Railroad Retirement Board benefits included in federal AGI (excluded) | |
| orItemizedDeductions | No | Schedule OR-A line 23 OREGON itemized deductions (Oregon's own computation — never the federal Schedule A total). The composer takes the larger of this and the standard deduction. | |
| scConsumerProtection | No | SC line u: identity-theft/consumer protection services purchased after a security breach notification — the composer caps at $300 (individual) / $1,000 (joint or with dependents) | |
| scNetLtcgAfterLosses | No | net LONG-TERM capital gain held over one year, AFTER netting ALL capital losses (short-term included — the printed example nets an ST loss against the LT gain first) — the composer takes the 44% deduction (line i) | |
| vaItemizedCharitable | No | VA Sch A charitable contributions (federal Schedule A amount) | |
| vaItemizedOtherTaxes | No | VA Sch A line 6 other taxes (foreign income tax etc.) | |
| vaItemizedSalesTaxes | No | VA Sch A line 5a when the general SALES tax election was made federally — capped at the Virginia SALT cap ($40,000; $20,000 MFS for TY2025) | |
| vtChildrenSixOrUnder | No | Schedule IN-112 Part II line 3: qualifying children six or younger at the close of the calendar year (born 2019-2025 for tax year 2025) — $1,000 each, phased out $20 per $1,000 of federal AGI over $125,000 | |
| vtExemptBondInterest | No | Schedule IN-112 Part I line 15: interest from Vermont Student Assistance Corporation, Build America, Vermont Telecommunications Authority and Vermont Public Power Supply Authority bonds included in federal AGI | |
| vtRailroadRetirement | No | Schedule IN-112 Part I line 14: Railroad Retirement Tier 1 and Tier 2 benefits included in federal AGI — exempt in full | |
| vtRetirementElection | No | Schedule IN-112 line 12: the § 5830e(e)(1) election — exclude EITHER federally taxable Social Security ('social_security', using taxableSocialSecurity) OR up to $10,000 of Civil Service / other non-Social-Security contributory system income ('contributory_system', using vtContributorySystemIncome). Only one may be elected; the military exclusion is separate and additional | |
| vtVheipBeneficiaries | No | Schedule IN-119 Part II line 1: the number of VHEIP beneficiaries contributed for | |
| vtVheipContributions | No | Schedule IN-119 Part II line 1: contributions to Vermont Higher Education Investment Plan (VT529) accounts — the credit is 10% of the first $2,500 per beneficiary ($5,000 joint) | |
| wiItemizedComponents | No | Form 1 Schedule 1 lines 1-4 total: federal Schedule A medical + interest (EXCLUDING out-of-state second homes, boat residences, and U.S.-security carrying interest) + charity + casualty — the composer takes 5% of the excess over the line 8 standard deduction | |
| wiRetirement67Income | No | qualified-plan/IRA retirement income of the 67+ individual(s) for the NEW 2025 Act 15 subtraction (SB line 16, $24,000/$48,000 cap) — CAUTION: claiming it FORFEITS every credit on lines 13-20, 30-35, and Schedule CR (the composer enforces this); compare both ways before passing | |
| wvMilitaryRetirement | No | WV Schedule M line 32 column A: military retirement including survivorship annuities (100%) | |
| wvRailroadRetirement | No | WV Schedule M line 40: Railroad Retirement Board income in federal AGI (100%) | |
| arConsideredUnmarried | No | AR2441 status 5 only: the filer meets the 'considered unmarried' tests (lived apart the last 6 months, kept up the qualifying person's home) — otherwise a status 5 filer cannot claim the child care credit | |
| arOtherMiscDeductions | No | AR3 lines 26-28: volunteer firefighter expenses (≤ $1,000), gambling losses (≤ winnings), other deductions not subject to the 2% floor | |
| arSpouseShortTermGain | No | AR status 4 column B (AR1000D): the spouse's net short-term capital gain or loss | |
| ctEitcQualifyingChild | No | at least one qualifying child listed on federal Schedule EIC (Schedule CT-EITC lines 4-5) — adds the flat $250 to the 40% Connecticut EITC (PA 25-168, TY2025+) | |
| ctHistoricHomesCredit | No | CT-1040 line 20d: Historic Homes Rehabilitation Tax Credit voucher amount (refundable) | |
| ctSsProvisionalExcess | No | federal Social Security Benefits Worksheet line 9 (provisional income over the $25,000/$32,000 base) — or line 7 for a married-filing-separately filer who lived with the spouse — CT worksheet line B | |
| deSpousePensionIncome | No | COLUMN A: the spouse's pension income for the line 6 exclusion — spouses each receive their own exclusion | |
| gaItemizedAdjustments | No | Form 500 line 12b: state income taxes in the federal Schedule A total plus the disallowed-SALT proration when the $10,000/$5,000 cap bound (printed formula, hand-computed) | |
| gaSpouseExclusionTier | No | spouse's GA retirement-exclusion tier (each spouse qualifies separately; never shared) | |
| hiEstimatedTaxPenalty | No | HI line 50: Form N-210 estimated tax penalty (added to the payment, or subtracted from the refund) | |
| hiOtherMiscDeductions | No | HI Worksheet A-6 line 30: deductions not subject to the 2% floor (gambling losses to the extent of winnings, impairment-related work expenses) | |
| idFederalNolDeduction | No | ID Form 39R Part A line 1: federal NOL deduction included on Form 40 line 7 (added back) | |
| idHomeFamilyDeduction | No | ID: take the $1,000-per-member Form 39R Part B line 15 deduction instead of the $100 Part E credit | |
| idInvestmentTaxCredit | No | ID Form 44 Part I line 1: investment tax credit (Form 49) — the youth/rehab facility credit's remaining-tax limit subtracts this line specifically | |
| ksEstimatedTaxPenalty | No | KS line 31: underpayment of estimated tax penalty from Schedule K-210 (applies when line 18 less withholding and refundable credits is $500 or more) | |
| meUnderpaymentPenalty | No | ME line 32: Form 2210ME underpayment of estimated tax penalty | |
| mnAdvanceCtcRepayment | No | M1 line 14b: repayment of 2025 ADVANCE Child Tax Credit payments elected on the 2024 return (reconciliation, NEW for 2025) | |
| mnNetInvestmentIncome | No | Schedule NIIT Minnesota net investment income (federal 8960 concept minus class 2a agricultural-land gains) — the composer evaluates us.mn.niit (1% over $1,000,000) into line 14a | |
| mnSsAlternativeMethod | No | the M1M Worksheet ALTERNATIVE-method Social Security subtraction (steps 9-28, agent-computed, NET of the Tier 1 RR offset) — the composer takes the GREATER of this and the oracle simplified method when AGI exceeds the full-subtraction threshold (2025 alternative maxes: $5,840 MFJ/QSS, $4,560 single/HOH, $2,920 MFS) | |
| mnUnderpaymentPenalty | No | M1 line 27: Schedule M15 underpayment penalty | |
| moNetStateIncomeTaxes | No | MO-A Part 2 line 11: state/local income taxes from Schedule A line 5a MINUS Kansas City/St. Louis earnings taxes (which stay deductible) — or the Part 2 worksheet result when SALT exceeded $40,000/$20,000-MFS or FAGI exceeded $500,000/$250,000-MFS | |
| moPublicPensionSpouse | No | the spouse's public-source pension for their Section A column | |
| moUnderpaymentPenalty | No | MO-1040 line 55: Form MO-2210 underpayment penalty (90% / 66⅔%-farmer safe harbors) | |
| ncPartnershipPayments | No | D-400 line 21c: NC tax paid by a partnership on the filer's behalf | |
| neUnderpaymentPenalty | No | NE line 56: Form 2210N penalty for underpayment of estimated tax | |
| neVolunteerResponders | No | NE line 46: qualified volunteer emergency responders on the return certified to DOR for at least two years (0-2) — $250 each, refundable | |
| njNjbestContributions | No | NJ-1040 line 37a NJBEST 529 contributions (composer caps at $10,000; all three 37a-c require gross income ≤ $200,000) | |
| nmAge65OrBlindPersons | No | NM PIT-ADJ line 13: taxpayer and spouse who are 65 or older OR blind (0-2; one per person even if both) — up to $8,000 each by AGI | |
| nmModifiedGrossIncome | No | NM PIT-RC line 12 modified gross income: ALL income of the taxpayer, spouse, and dependents, taxable or not, undiminished by losses (wages, gross Social Security and pensions, unemployment, public assistance, business profit, gross capital gains, gifts, interest, child support). REQUIRED for the LICTR, property tax rebates, and child day care credit — omitted, those sections are skipped with a note | |
| nmUnderpaymentPenalty | No | NM PIT-1 line 34: penalty on underpayment of estimated tax (RPD-41272 / PIT-ES instructions) | |
| okEicEarnedIncome2024 | No | Form 511-EIC line 15 (Tax Year 2024 column): the PRIOR year's total earned income — Oklahoma lets the filer use 2024 or 2025 earned income; when given (with okEicAgi2024) the composer computes both columns and keeps the larger (line 20). Omit if the filer had no 2024 Oklahoma filing requirement. | |
| okEicEarnedIncome2025 | No | Form 511-EIC line 15 (Tax Year 2025 column): total earned income — 1040 line 1z wages less excluded Medicaid waiver payments, plus elected nontaxable combat pay, plus net self-employment earnings (Schedule SE line 3 + 4b + 5a − line 13, statutory employee Schedule C line 1). The composer looks it up in the printed 2020 EIC table (us.ok.eic_2020_rules) with federalAGI as line 17. | |
| okFederalSaltDeducted | No | state and local income OR sales taxes from Schedule A line 5a to the extent included in line 5e after the SALT cap (Schedule 511-D line 2 add-back) | |
| okGovRetirementSpouse | No | OK Schedule 511-A line 5, SPOUSE: the spouse's own government retirement (separate $10,000 cap) | |
| okSpecialExemptions65 | No | count of 65-or-older boxes (taxpayer/spouse, 0-2) — $1,000 each ONLY when federal AGI less Roth conversions is at or under $15,000 single / $25,000 joint / $12,500 MFS / $19,000 HOH (not listed for QSS — the composer denies it and discloses) | |
| orCarryforwardCredits | No | OR-40 line 30: Schedule OR-ASC line E9 carryforward credits used this year (capped at the remaining tax by the composer) | |
| orCharitableCheckoffs | No | OR-40 line 49: Schedule OR-DONATE charitable checkoffs (reduce the refund) | |
| orExcessAptcRepayment | No | excess advance premium tax credit repayment (1040 Schedule 2 line 1a) — SUBTRACTED in the worksheet (floor 0) | |
| orInstallmentInterest | No | OR-40 line 21: interest on installment-sale deferred tax liability (9% annual rate for 2025) | |
| paEligibilityAddbacks | No | Schedule SP Section III nontaxable add-backs (gifts, inheritances, insurance proceeds, non-PA income, nontaxable military pay, excluded home-sale gain, educational assistance, outside cash support). NOT Social Security, eligible retirement benefits, child support, or workers' comp. | |
| paMsaHsaContributions | No | Schedule O codes M/H: MSA + HSA contributions at the federally-allowed amounts | |
| paSpDependentChildren | No | Schedule SP dependent CHILDREN count (child/stepchild/adopted; grandchild of a grandparent; foster child of a foster parent — never other relatives) claimable as federal dependents; each adds $9,500 to the Tax Forgiveness eligibility-income threshold | |
| paStudentLoanInterest | No | Schedule O code S: student loan interest PAID (new deduction for 2025; the composer caps at $2,500 — pass the uncapped amount) | |
| riSpousePensionIncome | No | RI Schedule M line 1t table, column (b): the SPOUSE's Form 1040 line 5b pension and annuity income (joint returns only), separately capped at $50,000 | |
| scRetirementIncomeYou | No | primary taxpayer's qualified retirement income (401(k)/403(b)/457, IRA, Keogh — EXCLUDING military retirement, which goes in scMilitaryRetirementYou) — the composer caps at $3,000 under 65 / $10,000 at 65+ (line p-1; us.sc.retirement_deduction) | |
| scUnderpaymentPenalty | No | SC1040 line 33: underpayment of estimated tax penalty (SC2210 attached) | |
| taxableSocialSecurity | No | federally TAXABLE social security (Form 1040 line 6b, from compute_return). REQUIRED whenever nonzero: VA (760 line 5 subtraction), CA (Schedule CA line 6 col B), and NY (IT-201 line 27) all subtract it — the composer applies the subtraction automatically; do NOT also fold it into the generic subtractions total. | |
| vaAgeQualifyingTested | No | count of filers born January 2, 1939 - January 1, 1961 (65+ for 2025 but income-tested): the composer computes $12,000 each, reduced dollar-for-dollar by AFAGI over $50,000 single / $75,000 married — where AFAGI = federal AGI MINUS the federally taxable social security (the SS exclusion is the step agents miss; Va. Code § 58.1-322.03(2)) | |
| vaSpouseAgeBlindBoxes | No | STA worksheet Part 1 line 2: spouse's 65+/blind box count (0-2) | |
| vaSpouseTaxAdjustment | No | OVERRIDE ONLY — the composer now computes the VA Spouse Tax Adjustment worksheet itself when vaYourVagi/vaSpouseVagi are provided. If passed, this amount wins. | |
| vtTaxableStateRefunds | No | Schedule IN-112 Part I line 10: taxable refunds of state and local income taxes reported on federal Form 1040 — subtracted | |
| wiBlindWorkerExpenses | No | blind worker transportation services qualifying expenses (Form 1 line 15 credits 50%) | |
| wiRentHeatNotIncluded | No | rent with heat NOT included (line 16a; 3.0% table) | |
| wvMotorVehicleTaxPaid | No | WV line 21A: personal property tax timely paid to the sheriff on owned motor vehicles — 100% refundable credit (§ 11-13MM-3; Schedule MV-1) | |
| wvMunicipalUseTaxRate | No | WV Schedule UT Part II: municipal use tax rate in percent (0.5 or 1) | |
| wvUnderpaymentPenalty | No | WV line 12: Form IT-210 underpayment penalty | |
| wvWorkersCompensation | No | WV Schedule HEPTC-1 line 4c: workers' compensation received | |
| alTaxableRetirementYou | No | primary taxpayer's OTHERWISE-TAXABLE retirement income (IRA/401(k)/SEP/Keogh/403(b) distributions after basis recovery) — defined-BENEFIT pensions, Social Security, Railroad Retirement, military, and US/AL government retirement are 100% EXEMPT and never entered. The composer applies the 65+ $6,000 Schedule RS exclusion (us.al.retirement_exclusion). | |
| arPensionTaxableSpouse | No | AR line 18B: the spouse's taxable employer pension / qualified IRA (status 2 or 4 only) — its own $6,000 exclusion | |
| arUnderestimatePenalty | No | AR line 52B: underestimate penalty from AR2210 line 17 or AR2210A line 48 (required when line 51 is over $1,000 unless an exception applies) | |
| caDepreciationAddition | No | CA depreciation-difference addition: federal depreciation (with § 168(k) bonus, which California NEVER conforms to) minus CA depreciation (plain MACRS on the same asset). Positive = CA income addition (Schedule CA col C on the business/rents line). Compute per-asset and disclose. | |
| ctCharityContributions | No | CT-1040 line 24a: contributions of the refund to designated charities from Schedule 5 line 70 (limited to the refund; irrevocable) | |
| ctPensionAnnuityIncome | No | Form 1040 line 5b taxable pensions and annuities MINUS military retirement pay, Railroad Retirement, and Connecticut teachers' retirement (the composer runs the Pension and Annuity Worksheet: 100% of this + 75% of ctIraDistributions in TY2025, × the federal-AGI phase-out decimal → Schedule 1 line 48b) | |
| ctPropertyTaxResidence | No | CT Schedule 3 line 60: property tax paid in the year to a Connecticut town on the PRIMARY RESIDENCE (bills due and paid in the year, incl. prepaid installments; no late payments, interest or fees) | |
| ctUnderpaymentInterest | No | CT-1040 line 29: interest on underpayment of estimated tax from Form CT-2210 (applies when line 14 less withholding and PE credit is $1,000 or more; leave blank to let DRS bill it) | |
| deUsObligationInterest | No | Form PIT-RES line 5: interest on United States obligations, including the attributable share of regulated investment company dividends | |
| hiGamblingLossesInMisc | No | HI Total Itemized Deductions Worksheet line 2d: the gambling and casualty/theft losses inside hiOtherMiscDeductions (protected from the overall limitation) | |
| hiHomeMortgageInterest | No | HI Worksheet A-3 lines 10-12: home mortgage interest and points (pre-TCJA $1,000,000 / $100,000 limits; home equity interest allowed) | |
| idEnergyDeviceCost2022 | No | ID Form 39R line 5d: device cost, 2022 (20%) | |
| idEnergyDeviceCost2023 | No | ID Form 39R line 5c: device cost, 2023 (20%) | |
| idEnergyDeviceCost2024 | No | ID Form 39R line 5b: device cost, 2024 (20%) | |
| idEnergyDeviceCost2025 | No | ID Form 39R line 5a: alternative energy device cost placed in service in 2025 (40%, ≤ $5,000) | |
| idLtcDeductedElsewhere | No | ID LTC worksheet line 14: long-term care premiums deducted elsewhere on the federal return | |
| idNonIdahoBondInterest | No | ID Form 39R Part A line 3: interest and dividends from non-Idaho state and local bonds, net of expenses (added) | |
| idParentalChoiceCredit | No | ID line 42: approved Parental Choice Tax Credit qualified expenses (refundable, up to the approved amount) | |
| idQualifiedCapitalGain | No | ID Form 39R Part B line 10 (Form CG): capital gain net income from qualified Idaho property (real property held 12+ months, etc.) — 60% deductible | |
| ksChildrenBornThisYear | No | dependent children born during the tax year — additional $2,320 exemption each | |
| meCasualRentalSalesTax | No | ME line 30a: sales tax collected on casual rentals of living quarters (9%; $2,000 or less) | |
| meNonMaineBondInterest | No | ME Schedule 1A line 1: income from municipal and state bonds other than Maine (added) | |
| meOtherJurisdictionTax | No | ME other-jurisdiction credit worksheet line 4b: income tax paid to the other jurisdiction on that income (not withholding) — enclose that return | |
| mnWildlifeContribution | No | M1 line 18: Nongame Wildlife Fund contribution (reduces the refund) | |
| moBusinessIncomeSpouse | No | the spouse's net business income for the 20% deduction (17S) | |
| moEnterpriseZoneSpouse | No | MO-1040 line 28S | |
| moInactiveDutyMilitary | No | MO-1040 line 19: inactive duty (drill) military income deduction | |
| moPrivatePensionSpouse | No | the spouse's private-source pension for Section B | |
| moResidentCreditSpouse | No | MO-1040 line 31S (capped at 30S) | |
| mtGrossHouseholdIncome | No | Schedule 2EC line 18: GROSS household income — ALL income of ALL household members, taxable and non-taxable: the full amount of pensions and annuities, Railroad Retirement and veterans' disability benefits, excluded capital gains, alimony, support money, cash public assistance, tax-exempt interest, ALL Social Security, and refundable credits received in cash (expressly including the 2024 Montana property tax rebate). This is NOT federal AGI. Must be under $45,000 | |
| mtScheduleIvOtherTaxes | No | Form 2 line 19: contributions, penalties, interest and other taxes from Schedule IV line 8 — SUBTRACTED from total payments on line 21 rather than added to the tax | |
| ncUnderpaymentInterest | No | D-400 line 26e: interest on the underpayment of estimated income tax (Form D-422) | |
| ncUsObligationInterest | No | NC Schedule S line 18: interest from US obligations (Treasuries, savings bonds) included in FAGI — fully deducted | |
| ndFederalTaxableIncome | No | REQUIRED for North Dakota. Form ND-1 line 1b: federal TAXABLE income from federal Form 1040 line 15 — North Dakota starts here, not from AGI. May be NEGATIVE: the booklet directs a filer whose federal taxable income calculates below zero to enter the negative number even though Form 1040 line 15 shows 0 — and gives Form ND-EZ line 1b the identical instruction | |
| ndLowerQualifiedIncome | No | Marriage Penalty Credit Worksheet lines 3-4: the qualified income of the LOWER-earning spouse — wages and tips from federal line 1z, net self-employment income less the self-employment tax deduction, and the taxable IRA, pension, annuity and Social Security amounts, all reduced by the Form ND-1 line 8 and line 15 exclusions. Must exceed $47,550 for 2025 | |
| ndOtherStateIncomeBase | No | Schedule ND-1CR line 2: the ratio denominator. Defaults to federal AGI less the line 5 United States obligation interest, which is the printed full-year-resident rule; a part-year resident uses Schedule ND-1NR line 18 instead | |
| ndUnderpaymentInterest | No | Form ND-1 line 37: interest on underpaid estimated tax from Schedule ND-1UT — added into the line 36 balance due | |
| ndUsObligationInterest | No | Form ND-1 line 5: interest from United States obligations. The booklet's enumerated list EXCLUDES Freddie Mac, Fannie Mae, Ginnie Mae, federal tax refunds and repurchase agreements | |
| neFederalElderlyCredit | No | NE line 20: the federal credit for the elderly or the disabled (Schedule R, Schedule 3 line 6d) — Nebraska allows the same amount, nonrefundable | |
| njUnderpaymentInterest | No | NJ-1040 line 52 interest on underpayment of estimated tax (Form NJ-2210) | |
| ohFederalCdccTentative | No | federal Form 2441 line 9c (tentative credit before the federal liability limit) — the Ohio CDCC pays 100% of it when MAGI < $20,000 | |
| okFederalItemizedTotal | No | federal Schedule A line 17 total itemized deductions (Schedule 511-D line 1) | |
| okGrossHouseholdIncome | No | Forms 538-S / 538-H: TOTAL gross household income of everyone in the household, taxable or not — wages incl. nontaxable W-2 amounts, interest, dependents' income, full Social Security incl. Medicare premiums, pensions/IRAs, alimony, unemployment, EIC received, public assistance, child support, workers' comp, gross rents/business receipts; NOT deferred 401(k)/IRA contributions or gifts | |
| okRothConversionIncome | No | Roth IRA conversion income included in federal AGI — excluded from AGI for the special 65+ exemption limits only (attach Form 8606) | |
| okUnderpaymentInterest | No | OK line 40: underpayment-of-estimated-tax interest from Form OW-8-P (none when the income tax liability is under $1,000; when there is also an overpayment the composer nets it against the refund per the printed instruction) | |
| orDisabilityExemptions | No | severe-disability boxes (6a/6b) + children with a qualifying disability (6d) — $256 each, $0 cliff above $100,000 federal AGI for EVERY filing status | |
| paSpouseRentRoyaltyNet | No | PA-40 line 6, spouse's own net rent/royalty amount | |
| paUnreimbursedExpenses | No | PA-40 line 1b: Schedule UE unreimbursed employee business expenses (a compensation-class expense, never a line-10 deduction) | |
| scFederalTaxableIncome | No | REQUIRED for SC: federal Form 1040 line 15 TAXABLE income (from compute_return, verbatim) — the SC1040 line 1 starting point (NOT federal AGI). A NEGATIVE amount is allowed: the composer enters $0 on line 1 and preserves the loss on subtraction line r per the printed instructions. | |
| spouseStateWithholding | No | VA line 19b spouse withholding (spouse's own W-2/1099/VK-1 boxes + spouse's half of jointly-issued documents' withholding, odd dollar to the primary) | |
| vtEligibleLongTermGain | No | Schedule IN-153 Part II line 17: net adjusted capital gain on assets held MORE than three years, excluding a primary or nonprimary residence, depreciable personal property (other than farm property and standing timber) and publicly traded stocks, bonds and financial instruments — 40% is excludable up to $350,000 | |
| vtFederalTaxableIncome | No | Schedule IN-153 line 20: federal taxable income (Form 1040 line 15) — the capital gains exclusion cannot exceed 40% of it; REQUIRED whenever a capital gain is passed | |
| vtSelfEmploymentIncome | No | Form IN-111 line 21 worksheet line 1: net earnings from self-employment, federal Schedule SE line 6 — the child care contribution is 0.11% of the Vermont-source portion | |
| vtUsObligationInterest | No | Schedule IN-112 Part I line 7: interest income from U.S. government obligations — also subtracted from federal AGI before the 3% minimum tax on line 8 | |
| vtUseTaxLargePurchases | No | Use Tax Worksheet line 3a: total untaxed purchases of items of $1,000 or more each (6%, always itemized) | |
| vtUseTaxPaidOtherState | No | Use Tax Worksheet line 3d: sales tax paid to another state on those purchases | |
| vtUseTaxSmallPurchases | No | Use Tax Worksheet line 2a: total recorded untaxed purchases of items under $1,000 each (6%) | |
| wiScheduleIAdjustments | No | Form 1 line 2: Schedule I net adjustment (may be negative) converting federal AGI to Wisconsin's IRC — Wisconsin conforms to the Code as of December 31, 2022, so post-2022 federal changes (incl. the 2025 OBBBA) need Schedule I conversion per its instructions | |
| wvLongTermCarePremiums | No | WV Schedule M line 41: long-term care insurance premiums | |
| wvOtherHouseholdIncome | No | WV Schedule HEPTC-1 line 4e: income of other household members who would file separately | |
| wvPoliceFireRetirement | No | WV Schedule M line 31 column A: West Virginia state or local police, deputy sheriffs', or firemen's retirement (100%, excluding PERS) | |
| arPensionTaxablePrimary | No | AR line 18A: the primary's TAXABLE employer-plan pension and qualified traditional IRA distributions (1099-R box 2a; IRA after 59½ or on death/disability) — the composer applies the $6,000 exclusion | |
| deSpouseMilitaryPension | No | COLUMN A: the spouse's pension is a United States military pension | |
| deVolunteerFirefighters | No | Form PIT-RES line 29: qualifying active volunteer firefighters or volunteer fire company auxiliary, ambulance or rescue squad members on the return (0-2) at $1,000 each. The Division verifies this credit before processing, so it defaults to none | |
| hiDependentCareBenefits | No | HI Schedule X line 18: employer dependent care benefits deducted or excluded (Section B lines 14 + 15) — reduce the expense cap | |
| hiOtherStateTaxEligible | No | HI Other State and Foreign Tax Credit Worksheet line 9: income tax paid to other states plus foreign tax not credited federally (exclude tax on Hawaii-exempt income; attach the other returns) | |
| hiPersonalPropertyTaxes | No | HI Worksheet A-2 line 7: personal property taxes paid to other states | |
| hiPresentOverNineMonths | No | HI Form N-311 / Schedule X attestation: every claimed exemption (you, spouse, dependents) was physically present in Hawaii more than nine months in 2025 — REQUIRED for the food/excise and renters credits (unattested → not claimed) | |
| hiStateLocalIncomeTaxes | No | HI Worksheet A-2 line 5: state and local income taxes (or the elected general sales taxes) — deductible only when federal AGI is under $100,000 single/MFS, $150,000 HOH, $200,000 MFJ/QSS; exclude taxes claimed under the other-state credit | |
| idOrganDonationExpenses | No | ID Form 39R Part D line 3: unreimbursed live organ donation travel, lodging, and lost wages (≤ $5,000; five-year carryover) | |
| idPersonalPropertyTaxes | No | ID line 14 input: Schedule A line 5c personal property taxes | |
| ilSpouseTeacherExpenses | No | IL Schedule 1299-I column B: the SPOUSE's own educator materials expenses on a joint return — its own $500 cap | |
| mdNetCapitalGainSubject | No | Form 502CG line 9: net capital gain subject to the H.B. 352 2% surtax (line 1c gain minus the six exempt classes — primary-residence sale under $1.5M, retirement-plan assets, livestock, easement land, trade-or-business property, nonprofit affordable housing). The composer zeroes it (with a note) unless FAGI exceeds $350,000. | |
| meRentIncludesUtilities | No | ME Schedule PTFC/STFC line 5b: the rent includes heat, utilities, furniture, or similar items | |
| mnDependentEarnedIncome | No | dependent-claimed filer's earned income for the dependent standard-deduction worksheet (lesser of the table amount or max($1,250, earned + $350)) | |
| mtActiveDutyMilitaryPay | No | Schedule I line 12: active-duty military salary, subtracted in full (§ 15-30-2120(3)(c)) — basic, special and incentive pay only. Annual training, inactive duty training and 'active Guard and Reserve duty' pay do NOT qualify | |
| mtOtherStateTotalIncome | No | Schedule III Part II lines 2 and 12: ALL income sourced and taxable to the other state or country — the denominator of the first ratio | |
| mtScheduleK1Withholding | No | Form 2 line 11d: total withholding from Montana Schedule(s) K-1, including mineral royalty withholding | |
| mtSoleHouseholdClaimant | No | Schedule 2EC: you are the only member of your household claiming the elderly homeowner/renter credit — only one per household (unattested → not claimed) | |
| mtStateIncomeTaxAddback | No | Schedule I Part I line 4: state income tax included in federal ITEMIZED deductions, added back — computed on Worksheet B and capped so it never reduces the federal itemized total below the federal standard deduction (§ 15-30-2120(2)(j)). New placement for TY2025 | |
| ncClaimOfRightRepayment | No | NC Schedule A line 8: claim-of-right repayments over $3,000 (deducted in full) | |
| ndPlannedGiftAdjustment | No | Form ND-1 line 2: the planned gift or endowment tax credit adjustment to income, from Schedule ND-1PG line 15 or Schedule ND-1QEC line 16 — an ADDITION, because the contribution that earned the credit also reduced federal taxable income | |
| neCommunityCollegeTaxes | No | NE line 45 (Form PTC line 2a → line 1): community college property taxes paid in 2025 on parcels you own — 100% refundable credit (the school district credit ended with LB 34; use the DOR Look-up Tool) | |
| njOrganDonationExpenses | No | NJ-1040 line 36 organ/bone-marrow donation expenses (composer caps at $10,000) | |
| njPensionEligibleAmount | No | joint returns where only ONE spouse is 62+/disabled: that spouse's share of line 20a (the exclusion never covers the ineligible spouse's pension). Defaults to all of line 20a. | |
| nmChildDayCareWorksheet | No | NM PIT-RC line 19 base: the sum of column G on the Child Day Care Credit Worksheet (40% of caregiver pay at up to $8 per day, up to $480 per child) — the composer caps at $1,200, subtracts the federal child care credit, and applies the $30,160 MGI limit | |
| okEicQualifyingChildren | No | EIC qualifying children under the 2020 federal rules (0, 1, 2, or 3+) | |
| okFederalChildTaxCredit | No | federal child tax credit PLUS additional child tax credit allowed (1040 line 19 + line 28, Schedule 8812) — Oklahoma allows 5% (line 15, greater-of test). Line 19 includes the $500 § 24(h)(4) other-dependent credit; the packet names only the CTC/ACTC — include it (it is part of § 24) and disclose when present | |
| okNaturalDisasterCredit | No | OK line 26: Natural Disaster Tax Credit from Form 576 (refundable; transcribed) | |
| okOtherRetirementSpouse | No | OK Schedule 511-A line 6, SPOUSE: the spouse's own other retirement income | |
| orDependentEarnedIncome | No | dependent-claimed filer's earned income — the standard deduction is limited to max($1,350, earned + $450), capped at the Table 5 amount | |
| riCheckoffContributions | No | RI Checkoff Schedule line 38: voluntary contributions (drug program, Olympic $1/$2 joint, organ transplant, arts council, nongame wildlife, childhood disease, military family relief, behavioral health) — these INCREASE the balance due or reduce the refund | |
| riTaxpayerPensionIncome | No | RI Schedule M line 1t table, column (a): YOUR federally taxable pension and annuity income from Form 1040 line 5b ONLY. Do NOT include IRAs (line 4b), Railroad Retirement (line 1d), or a military service pension (line 1v). Capped at $50,000 per person for 2025 | |
| scMilitaryRetirementYou | No | primary taxpayer's military retirement income — 100% deductible since TY2022 (line p-4); per the printed worksheet it REDUCES the same person's retirement-deduction CAP and age-65 deduction (instructions Example 5: $16,000 military at 65+ leaves $0 on lines p-1 and q-1) — the composer handles the interplay | |
| vaScheduleAdjDeductions | No | Schedule ADJ line 9 total deductions (deduction CODES like 105 continuing-teacher-education, 199 other) — prints on Form 760 line 13; these are DEDUCTIONS from VAGI, never income subtractions on line 7 | |
| vtRealEstateWithholding | No | Form IN-111 line 26d: 2025 Vermont real estate withholding from Form RW-171 | |
| wiDependentEarnedIncome | No | a dependent-claimed filer's earned income for the Standard Deduction Worksheet for Dependents (deduction = smaller of the table amount or max($1,350, earned + $450)) | |
| wiEicQualifyingChildren | No | federal-EIC qualifying children — Wisconsin EIC = 4%/11%/34% of the federal credit for 1/2/3+ children (NO childless credit; MFS ineligible; full-year residents only) | |
| wvSmart529Contributions | No | WV Schedule M line 39: SMART529 / Prepaid Tuition Trust contributions (no cap; annual statement required) | |
| wvSpouseAge65OrDisabled | No | WV Schedule M line 47 column B: the spouse is 65 or older or certified disabled (joint returns) | |
| arEarlyChildhoodApproved | No | AR line 43: the qualifying child attends an APPROVED early childhood program (Form AR1000EC certificate) — the 20% AR2441 credit becomes REFUNDABLE on line 43 instead of nonrefundable on line 35 | |
| arPoliticalContributions | No | AR1000TC line 1: cash contributions to Arkansas state/local candidates, approved PACs, or parties (by April 15, 2026) — credit capped at $50 per taxpayer ($100 status 2/4) | |
| caAb5GrossIncomeAddition | No | gross income from businesses where the worker is classified as an EMPLOYEE for California (AB 5/Dynamex reclassification; the intake's ca_form540_schca.add_gross_income field) — Schedule CA WAGE addition, col C | |
| caHsaTaxableDistribution | No | HSA distribution amount taxed federally (Form 8889 line 16) — not income for California: the composer SUBTRACTS it for CA | |
| ctChetRefundContribution | No | CT-1040 line 24: overpayment contributed to CHET accounts from Schedule CT-CHET line 4 (irrevocable) | |
| deFederalChildCareCredit | No | Form PIT-RES line 31 worksheet: the federal child and dependent care credit (federal Form 2441 line 11). Delaware allows 50%, capped at $3,000 and at the tax | |
| deSpouseOtherStateIncome | No | COLUMN A: the spouse's income from another state | |
| gaEligibleItemizerCredit | No | Form 500 line 19: Georgia Eligible Itemizer Tax Credit (NEW 2025; up to $300 per taxpayer, itemizers with 183+ GA days or resident at year end) — TRANSCRIBE the worksheet-computed amount, never assume the full $300; composer caps at $300/$600 | |
| gaRetirementEarnedIncome | No | primary taxpayer's earned income — at most $5,000 counts inside the exclusion (Schedule 1 worksheet) | |
| gaSpouseRetirementIncome | No | spouse's unearned retirement income for the exclusion | |
| hiInvestmentInterestN158 | No | HI Tax on Capital Gains Worksheet line 9: Form N-158 line 4e (net capital gain elected as investment income) | |
| hiMfsConsideredUnmarried | No | HI Schedule X Part II checkbox: married filing separately but lived apart from the spouse the last six months of 2025, kept the qualifying person's home, and paid over half its cost | |
| hiNetLongTermCapitalGain | No | HI Tax on Capital Gains Worksheet line 4: Hawaii net long-term capital gain (federal Schedule D line 15 plus Hawaii adjustments) | |
| hiOutOfStateBondInterest | No | HI line 9: interest on bonds of other states and their subdivisions (including mutual fund distributions from them) | |
| idOtherRefundableCredits | No | ID line 49: Tax Reimbursement Incentive credit and Claim of Right credit | |
| idSaltIncomeOrSalesTaxes | No | ID line 14 input: federal Schedule A line 5a state and local income taxes or general sales taxes | |
| idSocialSecurityBenefits | No | ID Form 39R line 8c: Social Security benefits RECEIVED (SSA-1099 Box 5, gross) — reduces the $48,216 / $72,324 retirement deduction maximum | |
| ksFederalChildCareCredit | No | federal child and dependent care credit ALLOWED (Form 2441 / Schedule 3 line 2) — Kansas allows 50% on line 14, nonrefundable, residents only | |
| meFederalChildCareCredit | No | ME child care credit: the federal child and dependent care credit (Schedule 3 line 2) — 25% (50% for Star 5 provider expenses), up to $500 refundable | |
| meSocialSecurityReceived | No | ME pension worksheet P3 (taxpayer): total Social Security and railroad retirement benefits RECEIVED, taxable or not — reduces the $48,216 cap | |
| meStar5ChildCareExpenses | No | ME child care worksheet line 1a column B: expenses paid to a Star 5 quality certificate provider | |
| moWftcInvestmentOver4400 | No | Form MO-WFTC question 3: investment income exceeds $4,400 — denies the credit. The MO credit follows EIC law FROZEN as of January 1, 2021 (MO-1040 instructions p.10), so this is the indexed pre-ARPA limit; compute investment income the pre-2021 way (taxable AND tax-exempt interest, dividends, positive net capital gain per the MO-WFTC instructions), NOT the current federal $11,950 gate. | |
| mtOtherStateCapitalGains | No | Schedule III Part II line 11: net long-term capital gain sourced and taxable to the other state or country | |
| mtOutOfStateBondInterest | No | Schedule I Part I line 1: interest and mutual fund dividends from state, county or municipal bonds of states OTHER than Montana | |
| ndNetLongTermCapitalGain | No | Net long-term capital gain worksheet line 3: the SMALLER of federal Schedule D lines 15 and 16 — or the capital gain distributions from Form 1040 line 7 when no Schedule D was required. North Dakota excludes 40%. The worksheet stops if either Schedule D figure is zero or less, so a net loss gives no exclusion | |
| ndPeaceOfficerRetirement | No | Form ND-1 line 9: the licensed peace officer retirement benefit exclusion — 20 years of licensed service or medical retirement for disability, employer plan benefits only | |
| ndVoluntaryContributions | No | Form ND-1 line 31 (when overpaid) or line 35 (when tax is due): total voluntary contributions to the Veterans' Postwar Trust Fund, Watchable Wildlife Fund and Trees for ND Trust Fund | |
| neFederalChildCareCredit | No | NE line 23: the federal child and dependent care credit (Schedule 3 line 2) — 25% nonrefundable when AGI is over $29,000 | |
| nmFederalChildCareCredit | No | NM PIT-RC line 21: the federal child and dependent care credit applied on Schedule 3 line 2 — subtracted from the New Mexico day care credit | |
| okFarmIncomeAveragingTax | No | OVERRIDE for line 14a: Form 573 farm income averaging tax (box 1) — agent-computed; replaces the table tax | |
| okFederalChildCareCredit | No | federal child and dependent care credit allowed (Schedule 3 line 2 / Form 2441) — Oklahoma allows 20% (line 15, greater-of test; $100,000 federal AGI cliff) | |
| orPoliticalContributions | No | 2025 cash contributions to qualified Oregon political parties/candidates/PACs — the composer caps at $50 ($100 joint) and denies above $75,000/$150,000 federal AGI | |
| orPoliticalPartyCheckoff | No | OR-40 line 50: political party $3 checkoff from the refund | |
| riFederalChildCareCredit | No | RI Schedule I line 20: the federal credit for child and dependent care expenses from federal Form 1040 Schedule 3, line 2 — Rhode Island allows 25% of it, capped at the line 8 tax (nonrefundable) | |
| riMilitaryServicePension | No | RI Schedule M line 1v: military service pension benefits as defined in 20 C.F.R. § 212.2, from Form 1040 line 5b (§ 44-30-12(c)(11)) — no cap, no age or income test; must not also appear in riTaxpayerPensionIncome | |
| riOutOfStateBondInterest | No | RI Schedule M line 2a: interest on obligations of any state or its political subdivisions OTHER than Rhode Island (§ 44-30-12(b)(1), (b)(2)) | |
| riSocialSecurityBenefits | No | RI Social Security Modification Worksheet line 8: TOTAL Social Security benefits, federal Form 1040 line 6a (the denominator of the eligible percentage). Exclude Railroad Retirement | |
| scRetirementIncomeSpouse | No | spouse's qualified retirement income for line p-2 (each spouse's own cap; joint returns) | |
| unemploymentCompensation | No | unemployment compensation included in federal AGI (Schedule 1 line 7). REQUIRED whenever nonzero: VA fully subtracts it (Va. Code § 58.1-322.02(9), Schedule ADJ) and CA excludes it (Schedule CA line 7 col B) — the composer subtracts automatically for those states; do NOT also fold it into the generic subtractions total. IL and NY tax it (no subtraction). | |
| vtEitcQualifyingChildren | No | Schedule IN-112 Part II line 5: number of qualifying children from federal Schedule EIC — one or more makes the Vermont credit 38% of federalEITC; none makes it 100% | |
| vtFederalAdditionalTaxes | No | Schedule IN-119 Part I line 4: federal additional tax on qualified plans, IRAs, HSAs and MSAs, recapture of the federal investment credit (Vermont portion) and Form 4972 lump-sum tax — 24% is ADDED to the Vermont tax on line 9 | |
| vtFederalChildCareCredit | No | Schedule IN-112 Part II line 1: the federal child and dependent care credit from Form 2441 line 11 — Vermont pays 72%, refundable | |
| vtFederalMedicalExpenses | No | Medical Deduction Worksheet line 1a: medical and dental expenses from federal Schedule A line 4 — only the excess over the Vermont standard deduction plus exemptions (Form IN-111 line 6) is subtracted on Schedule IN-112 line 11 | |
| vtNetAdjustedCapitalGain | No | Schedule IN-153 Part I line 8: net adjusted capital gain (the smaller of federal Schedule D lines 15 and 16, less qualified dividends and allocated investment interest) — the base of the $5,000 flat exclusion; $0 when the federal return shows a net capital loss | |
| vtNonVermontBondInterest | No | Schedule IN-112 Part I line 3: interest and dividends from NON-Vermont state and local obligations exempt from federal tax (line 1 less the Vermont-obligation portion on line 2) — an ADDITION | |
| vtVermontCreditRecapture | No | Schedule IN-119 Part I line 6: recapture of Vermont credits — added on line 9 | |
| vtVeteranDischargeRecord | No | Schedule IN-112 Part II lines 8-12: the filer has a discharge record or other record of separation from active duty verifying service in the uniformed services — the $250 refundable veteran credit, phased out between $25,000 and $30,000 of federal AGI (new for 2025) | |
| vtVoluntaryContributions | No | Form IN-111 line 24e: total voluntary contributions to the Vermont Veterans Fund, Green Up Vermont, Nongame Wildlife Fund and Vermont Children's Trust Foundation (lines 24a-24d) — added to the balance due or taken from the refund | |
| wiCapitalGainSubtraction | No | Schedule SB line 5 capital gain/loss subtraction from Schedule WD (30% net long-term gain exclusion, 60% farm assets; capital loss limit $3,000/$1,500-MFS since TY2023; simple mutual-fund/REIT distributions may take 30% directly) | |
| wvFederalChildCareCredit | No | WV Recap line 18: the federal child and dependent care credit (Form 2441) — 50% nonrefundable | |
| alTaxableRetirementSpouse | No | spouse's otherwise-taxable retirement income (Schedule RS Part III) | |
| ctOtherJurisdictionIncome | No | CT Schedule 2 line 53: income included in Connecticut AGI that was also taxed by ONE qualifying jurisdiction (another state, DC, or their political subdivisions — from the Schedule 2 Worksheet column 2); the composer computes lines 54-58 (ratio to four decimals ≤ 1.0000 × (line 6 − line 11), limited to the tax actually paid). Attach the other return. | |
| deCharitableContributions | No | Form PIT-RES line 43: DE Schedule III contributions to special funds — these INCREASE the balance due or reduce the refund; they are contributions, not credits | |
| deSpouseOtherStateTaxPaid | No | COLUMN A: income tax the spouse paid to another state | |
| hiCharitableContributions | No | HI Worksheet A-4 lines 15-17: gifts to charity within the 60% / 30% / 20% Hawaii AGI limits | |
| idFoodCreditPartialMonths | No | ID line 43 Food Tax Credit: total qualified months across household members qualified only part of the year ($12.92 each) — months on food stamps, incarcerated, or nonresident don't qualify; pass idFoodCreditPartialPersons with it | |
| idHomeFamilyPartialMonths | No | ID Form 39R Part E: total months for partially-qualified family members ($8.33 credit or $83.33 deduction per month) | |
| idMilitaryPayOutsideIdaho | No | ID Form 39R Part B line 11: active-duty military pay earned outside Idaho (120+ consecutive days) | |
| ksCharitableContributions | No | KS Schedule A line 13: gifts to charity by cash, other than cash, and carryover (100%, § 170 limits) | |
| mdItemizedStateLocalTaxes | No | MD line 17b: state and local INCOME taxes claimed in the federal Schedule A (plus preservation-easement contributions claimed as a credit) — subtracted from 17a | |
| meMaineTaxableIncomeCosts | No | ME Schedule 2 line 3a: costs of producing federally-exempt, Maine-taxable income | |
| meOtherJurisdictionIncome | No | ME other-jurisdiction credit worksheet line 2d: income sourced to and taxed by the other jurisdiction, adjusted for Maine modifications | |
| mePersonalPropertyTaxes5c | No | ME Schedule 2 line 3c: personal property taxes (Schedule A line 5c) — added back | |
| mtMilitaryRetireeEligible | No | MCA 15-30-2120(9)(a): the retiree became a Montana resident on or after June 30, 2023, or was a resident both before and after receiving the pension (unattested → no subtraction) | |
| mtMontanaSourceWageIncome | No | MCA 15-30-2120(8)(i): Montana source WAGE income, which caps the military retirement subtraction. A fully retired veteran with no wages gets $0 | |
| mtNetLongTermCapitalGains | No | Form 2 page 2 line 2: net long-term capital gains subject to the federal tax — generally the LESSER of federal Schedule D line 15 or line 16. Montana taxes these at 3% / 4.1%. Qualified dividends are NOT included: they are Montana ordinary income | |
| neFederalTaxBeforeCredits | No | NE line 35 Federal Tax Liability Worksheet line 3: Form 1040 line 16 + Schedule 2 line 2 + Schedule 2 line 8 — when net Schedule I adjustments (line 12 − 13) are under $5,000, Nebraska tax after nonrefundable credits cannot exceed this (§ 77-2715(1)). Omitted, the cap is skipped with a note | |
| njOtherRetirementEligible | No | line 28b Worksheet D gate: filer is 62 or older (the composer auto-computes the unclaimed exclusion when earned income ≤ $3,000 and line 27 ≤ $100,000) | |
| njShelteredWorkshopCredit | No | NJ-1040 line 46 Sheltered Workshop Tax Credit (GIT-317) | |
| nmIncomeTaxedByBothStates | No | NM line 20 worksheet line 4: the income subject to tax in BOTH states (capped at each state's taxable income) | |
| nmOtherStateTaxableIncome | No | NM line 20 worksheet (column 2 line 2): the other state's taxable income on which that tax was computed | |
| okAmendedPriorOverpayment | No | OK line 32 (amended return only): overpayment shown on the original / prior amended return or as previously adjusted | |
| orFederalOtherIncomeTaxes | No | other INCOME taxes from Schedule 2 lines 8, 16, 17 (income-tax recaptures only — never SE tax, SS/Medicare tip tax, household employment taxes, penalties, or excise) | |
| riLargePurchasesNetUseTax | No | RI Schedule U line 7e: net use tax on each SINGLE purchase of $1,000 or more (cost × 7% less sales tax paid), which must be listed individually and is added on top of the lookup-table amount | |
| riSalesTaxPaidOtherStates | No | RI Schedule U line 3: sales tax paid to other states on those purchases | |
| riSpouseFullRetirementAge | No | RI Schedule M lines 1s/1t: the spouse was born on or before March 1, 1959 (joint returns only — the (b) Spouse column and the worksheet's 'either you or your spouse' test) | |
| riUnderestimatingInterest | No | RI-1040 line 15b: underestimating interest from Form RI-2210 or RI-2210A — added to the amount due, or subtracted from the overpayment | |
| vaItemizedRealEstateTaxes | No | VA Sch A line 5b real estate taxes — NOT subject to the SALT cap for Virginia | |
| vtCharitableContributions | No | Form IN-111 line 11: charitable contributions allowable under IRC § 170, whether or not itemized federally — the credit is 5% of the first $20,000 | |
| vtSolarCreditCarryforward | No | Schedule IN-119 line 13: Vermont-based solar energy credit carryforward (at 24%) | |
| vtStudentLoanInterestPaid | No | Schedule IN-112 line 16a: total interest paid in the year on qualified student loans — the excess over the federal deduction is subtracted, unless federal AGI exceeds $200,000 (joint) or $120,000 (all others) | |
| vtUseTaxEstimateFromTable | No | Use Tax Worksheet Part 1: no records of untaxed purchases under $1,000 were kept — estimate them from the AGI table ($0 to $45 by $10,000 band; 0.05% of AGI, at most $150, above $100,000) | |
| vtVermontInvestmentCredit | No | Schedule IN-119 line 9: the federal investment tax credit attributable to Vermont property — 24% is credited | |
| wvNonFamilyAdoptionCredit | No | WV line 17: Non-Family Adoption Tax Credit (Schedule NFA-1) | |
| wvTaxpayerAge65OrDisabled | No | WV Schedule M line 47 column A: the taxpayer is 65 or older on December 31 or certified permanently and totally disabled — up to $8,000 modification net of lines 29-34 | |
| alFederalRefundableCredits | No | the line 12 worksheet's refundable-credit subtraction: 1040 line 27a EIC + line 28 ACTC + line 29 AOC + line 30 refundable adoption + Schedule 3 Part II line 13a Form 2439 credits | |
| arMilitaryRetirementSpouse | No | AR line 17: the spouse's military retirement (exempt) — reduces the spouse's $6,000 exclusion | |
| caEducatorExpensesDeducted | No | federal educator-expense deduction claimed (§ 62(a)(2)(D)) — California does NOT conform: the composer ADDS it back on Schedule CA (line 11 col C). Pass the federal amount actually deducted (both spouses' combined). | |
| caTaxableEarlyDistribution | No | retirement-plan early distribution amount subject to the FEDERAL § 72(t) additional tax — California imposes its own 2.5% additional tax on the same base (R&TC § 17085(c)(1), FTB 3805P); the composer computes 2.5% and prints it on Form 540 line 63 | |
| ctOtherJurisdictionTaxPaid | No | CT Schedule 2 line 57: income tax actually paid to that qualifying jurisdiction | |
| deAdditionalDeductionBoxes | No | Form PIT-RES line 21: boxes checked for age 65 or over and blindness — $2,500 each, at most two per person: up to four on a joint return, or on a married-filing-SEPARATE return (status 3) when the spouse's boxes qualify under § 1108(b)(2)/(4) (spouse 65+/blind with NO gross income, not another's dependent); two otherwise. On a combined separate return (status 4) this is COLUMN B's own two-box count | |
| deEligibleRetirementIncome | No | Form PIT-RES line 6, 60-or-over worksheet: dividends, capital gains net of losses, interest, net rental income from real property, and qualified plan distributions (IRA, 401(k), Keogh, IRC 457). Counts ONLY at 60 or over | |
| deQualifiesElderlyDisabled | No | Form PIT-RES line 11 worksheet: at least 60 years old OR totally and permanently disabled on December 31 | |
| deSpouseItemizedDeductions | No | COLUMN A (filing status 4): the spouse's own net Delaware itemized deductions. Section 1109(b) requires both spouses to make the SAME itemize-or-standard election, but each column deducts its own amount | |
| deTuitionAbleContributions | No | Form PIT-RES line 8b: DE529 contributions (up to $1,000, $2,000 joint, phased out entirely above $100,000 of federal AGI / $200,000 joint, K-12 tuition excluded) plus Delaware ABLE contributions (up to $5,000, $10,000 joint) | |
| hiSpouseClaimedAsDependent | No | HI line 6b: the spouse can be claimed as a dependent on another return — no spouse exemption (joint returns) | |
| idEducationalContributions | No | ID Form 39R Part D line 1: cash donated to qualified Idaho educational entities (50% credit, ≤ 50% of tax, ≤ $500 / $1,000 joint) | |
| idFoodCreditPartialPersons | No | ID line 43: how many household members are qualified only part of the year (they are removed from the $155 full-year count and paid $12.92 per month via idFoodCreditPartialMonths); defaults to 1 when partial months are given | |
| idReceivedPublicAssistance | No | ID line 31: receiving Idaho public assistance payments at year end (not food stamps/WIC) — no $10 permanent building fund tax | |
| mdTwoIncomeLesserSpouseNet | No | Worksheet 13D line 6: the LESSER-income spouse's net Maryland income (their FAGI share + additions share − subtractions share) — the composer caps it at $1,200 for line 14 (joint returns only) | |
| meSpouseClaimedAsDependent | No | ME line 13: the spouse can be claimed as a dependent on another return (MFJ → 1 exemption instead of 2) | |
| meSpouseNonMilitaryPension | No | ME pension worksheet P1 (spouse column, MFJ only — the spouse's own earned pension) | |
| mtMilitaryRetirementIncome | No | Schedule I line 13: military pension, military retirement income or military survivor benefits (Form WMRE). The subtraction is the LESSER of Montana source wage income or 50% of this — it is for WORKING military retirees | |
| mtOtherStateOrdinaryIncome | No | Schedule III Part II line 1: income sourced and taxable to the other state or country included in Montana taxable income, EXCLUDING net long-term capital gains | |
| ndCollegeSaveContributions | No | Form ND-1 line 12: contributions to a North Dakota College SAVE account (Bank of North Dakota) — capped at $5,000, or $10,000 on a JOINT return. Rollovers from another section 529 plan do NOT qualify | |
| neFederalStandardDeduction | No | NE line 6, REQUIRED when claimedAsDependent or neSpouseClaimedAsDependent (line 2b): the federal standard deduction actually allowed (Form 1040 line 12e) — the Nebraska deduction is the smaller of it and the chart amount | |
| neSpouseClaimedAsDependent | No | NE line 4b: the spouse can be claimed as another taxpayer's dependent — no exemption for the spouse | |
| njConservationContribution | No | NJ-1040 line 33 qualified conservation contribution (NJ land, federal amount) | |
| njOrganDonorEmployerCredit | No | NJ-1040 line 48 employer of organ/bone-marrow donor credit (25% of salary, up to 30 days) | |
| njOtherRetirementExclusion | No | OVERRIDE: hand-computed Worksheet D line 9 unclaimed exclusion (required for the $100,001-$150,000 percentage tiers) | |
| nmArmedForcesRetirementPay | No | NM PIT-ADJ line 24: the primary's armed forces retirement pay (or survivor benefit) in federal AGI — $30,000 exempt | |
| nmFederalStandardDeduction | No | NM line 10 worksheet line 7: the federal standard deduction the itemizer could have claimed instead | |
| riIndividualMandatePenalty | No | RI-1040 line 12b: individual mandate (health insurance) shared responsibility penalty — leave $0 and certify full-year coverage where it applies | |
| riSpouseClaimedAsDependent | No | RI Schedule E line 1b: the spouse can be claimed as a dependent on another return — no spouse exemption on a joint return | |
| scMilitaryRetirementSpouse | No | spouse's military retirement income (line p-5) | |
| vaItemizedMortgageInterest | No | VA Sch A home mortgage interest and points (federal Schedule A amount) | |
| vtAppliedToPropertyTaxBill | No | Form IN-111 line 28b: refund to be credited to the 2026 property tax bill | |
| vtBonusDepreciationAddback | No | Schedule IN-112 Part I line 4: federal bonus depreciation allowed under IRC § 168(k) (and, per the 2025 Federal Conformity Supplement, § 168(n) and large-business § 174A) — an ADDITION; use `additions` for anything else the Supplement routes here | |
| vtContributorySystemIncome | No | Retirement Income Exemption Worksheet line 11: income from the Civil Service Retirement System or another U.S., Vermont or other-state contributory system based on earnings NOT covered by Social Security — the first $10,000 is excludable under the 'contributory_system' election | |
| vtMilitaryRetirementIncome | No | Schedule IN-112 line 13: federally taxable U.S. military retirement and military survivor benefit income (Form 1040 line 5b, DFAS 1099-R) — excluded in full at federal AGI up to $125,000, phased out to $175,000, any filing status | |
| vtSpouseClaimedAsDependent | No | Form IN-111 line 5b: another person can claim the spouse as a dependent, so the joint return takes no spouse exemption | |
| wvFederalTaxExemptInterest | No | WV Schedule FTC-1 line 3 / HEPTC-1 line 4b: federal tax-exempt interest not already in line 2 | |
| wvMunicipalUseTaxPurchases | No | WV Schedule UT Part II: purchases used in a municipality with a municipal use tax | |
| wvNontaxableSocialSecurity | No | WV Schedule HEPTC-1 line 4d: Social Security, SSI, and SSDI received but not in federal AGI | |
| wvPersTrsFederalRetirement | No | WV Schedule M line 33 column A: West Virginia PERS / Teachers' Retirement plus federal retirement not on line 30 — the composer caps the combined amount at $2,000 per person | |
| wvSmallBusinessPropertyTax | No | WV line 21C: personal property tax timely paid by an eligible small business (≤ $1 million appraised), net of vehicle tax claimed in 21A — 50% credit (§ 11-13MM-5) | |
| wvSpouseClaimedAsDependent | No | WV exemption box (b): the spouse can be claimed as a dependent on another return — no spouse exemption | |
| wvSpouseMilitaryRetirement | No | WV Schedule M line 32 column B (spouse) | |
| wvSurvivingSpouseExemption | No | WV exemption box (d): an unremarried surviving spouse in one of the two taxable years after the year of the spouse's death — one extra $2,000 exemption | |
| arFederalEarlyWithdrawalTax | No | AR line 32 base: the FEDERAL Form 5329 Part I additional tax on early IRA/qualified plan distributions (plus Part II Coverdell) — Arkansas adds 10% of it | |
| arMilitaryRetirementPrimary | No | AR line 17: the primary's military retirement (100% exempt; informational box) — reduces the primary's $6,000 pension exclusion dollar for dollar | |
| hiExceptionalTreesDeduction | No | HI line 17: exceptional trees deduction (up to $3,000 per tree, once every three years; notarized arborist affidavit) | |
| idFederalItemizedDeductions | No | ID line 13: federal Schedule A line 17 total itemized deductions | |
| idFoodCreditExcludedPersons | No | ID line 43: household members who do NOT qualify for the Food Tax Credit at all (e.g. nonresident dependents, full-year food stamp recipients) — subtracted from the automatic full-year count | |
| meFederalItemizedDeductions | No | ME Schedule 2 line 1: federal Schedule A line 17 | |
| meFinancialInstitutionCosts | No | ME Schedule 2 line 2c: itemized amounts attributable to a pass-through financial institution ownership interest (removed) | |
| moStandardDeductionOverride | No | dependent-claimed filers: the federal DEPENDENT standard deduction limit (greater of $1,350 or earned income + $450, capped at the full amount) — replaces the composer's full standard deduction | |
| neFederalItemizedDeductions | No | NE line 7: federal Schedule A line 17 total itemized deductions | |
| orFederalRefundableAdoption | No | refundable adoption credit (1040 line 30) — subtracted | |
| riTaxpayerFullRetirementAge | No | RI Schedule M lines 1s/1t: you reached Social Security full retirement age — the Division's 2025 bright line is BORN ON OR BEFORE MARCH 1, 1959. Required for both the Social Security and the pension/annuity modification (unattested → no modification) | |
| vtFarmIncomeAveragingCredit | No | Schedule IN-119 line 10: the reduction in federal tax from farm income averaging (Schedule J) — 24% is credited | |
| wvSeniorCitizenCreditAmount | No | WV line 18: the Senior Citizens Tax Credit from the mailed Schedule SCTC-A Part III line 2 (Homestead Exemption participants; federal AGI ≤ 150% of poverty) | |
| arChildCareQualifyingPersons | No | AR2441 line 2: number of qualifying persons (1 → $3,000 cap; 2 or more → $6,000); defaults to 1 | |
| deSpouseUsObligationInterest | No | COLUMN A: the spouse's interest on United States obligations | |
| hiChildCareQualifyingPersons | No | HI Schedule X line 17: qualifying persons (1 → $10,000 cap; 2 or more → $20,000); defaults to 1 | |
| hiPublicSupportMinorChildren | No | HI Form N-311 line 3: minor children receiving more than half their support from public agencies (DHS, Social Security survivor benefits) who are NOT already counted in the shared `dependents` input (the form lists them on line 3 instead of line 2; a DHS-supported child claimed on line 6c is already in the default count) | |
| mtAmendedPreviousOverpayment | No | Form 2 line 20 (amended returns): previous overpayment | |
| mtPassThroughEntityTaxCredit | No | Form 2 line 11c: total pass-through entity tax credit from Montana Schedule(s) K-1, Part V line 1 | |
| mtRailroadRetirementBenefits | No | Schedule I lines 22-23: Tier I and Tier II Railroad Retirement benefits included in federal taxable income, exempt by federal law | |
| ndCapitalGainAlreadyExcluded | No | Net long-term capital gain worksheet line 6: the portion of that gain already included on Form ND-1 line 7 or line 16, which is removed BEFORE the 40% is applied | |
| ndRailroadRetirementBenefits | No | Form ND-1 line 8: Railroad Retirement Board benefits — unemployment, sick pay or retirement — to the extent federally taxable. Tier 1 Railroad Retirement belongs HERE, not on line 15 | |
| neChildCareQualifyingPersons | No | NE Form 2441N qualifying persons (1 → $3,000 cap; 2 or more → $6,000); defaults to 1 | |
| priorYearOverpaymentCredited | No | prior-year state overpayment applied toward this year's estimated tax. VA 760 line 21 (its own printed line — never fold into line 20 estimated payments). Other states: folded into the estimated-payments line. | |
| riRailroadRetirementBenefits | No | RI Schedule M line 1d: Railroad Retirement benefits taxed federally (1974 Railroad Retirement Act) — subtracted in full, and excluded from the Social Security and pension modifications | |
| scLowerQualifiedEarnedIncome | No | the LESSER-earning spouse's SC qualified earned income per the Two Wage Earner worksheet (earned income minus attributable federal adjustments) — line 12 credit = 0.7% capped at $50,000 base / $350 credit; MFJ only (us.sc.two_wage_earner_credit) | |
| vaItemizedInvestmentInterest | No | VA Sch A investment interest (protected from the overall limitation) | |
| vtPriorYearBonusDepreciation | No | Schedule IN-112 Part I line 9: the subtraction for prior years' bonus depreciation (standard MACRS less the federal amount; Technical Bulletin TB-44) | |
| wiFederalRetirementPenalties | No | the FEDERAL penalties on IRAs/retirement plans/MSAs etc. — Wisconsin charges 33% of them on line 25 ('x .33' printed) | |
| wiLowerQualifiedEarnedIncome | No | the LESSER-earning spouse's Schedule 2 line 5 qualified earned income (earned income minus the listed federal Schedule 1 adjustments) — married couple credit = 3% up to $480 (joint returns, both spouses employed) | |
| wvDisabledVeteranPropertyTax | No | WV line 21B: real property tax timely paid on a disabled veteran's (or eligible widowed spouse's) homestead — 100% refundable (§ 11-13MM-4); bars the SCTC and HEPTC | |
| wvNotRequiredToFileFederally | No | WV SCTC / HEPTC eligibility: not required to file a federal return — the poverty-guideline test then uses income less Social Security benefits (pass wvHouseholdIncomeLessSocialSecurity) | |
| wvSpousePoliceFireRetirement | No | WV Schedule M line 31 column B (spouse) | |
| alFederalTaxDeductionOverride | No | OVERRIDE for Form 40 line 12: the RATIOED federal tax for joint-federal/separate-Alabama returns (by each spouse's FAGI share) or part-year residents (AL-AGI/FAGI ratio) — wins over the composer's oracle computation | |
| deSpouseTaxableSocialSecurity | No | COLUMN A: the spouse's taxable Social Security and Railroad Retirement, subtracted in full | |
| deSpouseVolunteerFirefighters | No | COLUMN A: qualifying volunteer firefighters in the spouse column ($1,000 each) | |
| idCollegeSavingsContributions | No | ID Form 39R Part B line 14: Idaho College Savings Program (IDeal) contributions — capped at $6,000 ($12,000 MFJ) | |
| idMedicalSavingsContributions | No | ID Form 39R Part B line 13: Idaho medical savings account contributions plus interest — capped at $10,000 ($20,000 MFJ) | |
| mtAmendedPaymentsWithOriginal | No | Form 2 line 18 (amended returns): payments made with the original return | |
| mtTuitionSavingsContributions | No | Schedule I line 16: contributions to a Montana family education savings (§ 529) account — capped at $4,500, or $9,000 on a JOINT return, for 2025 (House Bill 845 raised it from $3,000) | |
| nmSpecialNeedsAdoptedChildren | No | NM PIT-RC line 24: certified special needs adopted children claimed as dependents — $1,500 each ($750 MFS), refundable | |
| ohBothSpousesQualifyingIncome | No | joint filing credit gate: EACH spouse has $500+ of qualifying income included in Ohio AGI (not interest/dividends/capital gains/rents, and not BID-deducted business income or deducted Social Security/retirement) | |
| orFederalTaxLiabilityOverride | No | OVERRIDE for the worksheet line 10 result (amended federal returns, foreign income tax, 1040-NR, recapture situations — Publication OR-17 worksheets); the Table 4 AGI cap still applies via the oracle | |
| riPreviouslyIssuedOverpayment | No | RI-1040 line 14h: previously issued overpayments (amended returns only) | |
| riTuitionSavingsContributions | No | RI Schedule M line 1g: contributions to a Rhode Island CollegeBound (§ 529) account — the composer caps the CONTRIBUTION modification at $500 ($1,000 on a joint return), 'regardless of the number of accounts'. Qualified withdrawals included in federal AGI are a separate, uncapped line 1g item — pass those in `subtractions` | |
| vtNonAllowableMedicalExpenses | No | Medical Deduction Worksheet line 1b: continuing care retirement community entrance fees and recurring monthly payments included in line 1a, which Vermont disallows | |
| vtUnderpaymentInterestPenalty | No | Form IN-111 line 31: interest and penalty on underpayment of estimated tax from Worksheet IN-152 or IN-152A | |
| wvSpouseTaxableSocialSecurity | No | WV Schedule M line 34 column B: the SPOUSE's share of federally taxable Social Security (taxableSocialSecurity is the joint total; the taxpayer's column is the remainder) | |
| wvSurvivingSpouseModification | No | WV Schedule M line 48: unremarried surviving spouse of a decedent who was 65 or disabled, in the taxable year after the death — up to $8,000 less lines 29-34 | |
| deDomiciledForPensionExclusion | No | TY2026+: the taxpayer has been legally domiciled in Delaware for at least three years — required for the 60-or-over pension exclusion under § 1106(b)(3)f.4 (85 Del. Laws c. 426, effective August 17, 2026); a 60-or-over person without it gets no pension exclusion. Not needed for TY2025 | |
| gaSpouseRetirementEarnedIncome | No | spouse's earned income for the exclusion worksheet | |
| idQualifyingRetirementBenefits | No | ID Form 39R line 8e: qualifying CSRS/FSRDS, Idaho firefighter, Idaho city police, or U.S. military retirement benefits included in federal income (not FERS, PERSI base plan, or private pensions) | |
| mdChildCareTwoOrMoreDependents | No | two or more care dependents — raises the MD line 9 expense cap from $3,000 to $6,000 | |
| meSpouseSocialSecurityReceived | No | ME pension worksheet P3 (spouse column) | |
| vtFederalElderlyDisabledCredit | No | Schedule IN-119 Part II line 8: the federal credit for the elderly or the disabled (Schedule R) — 24% is a nonrefundable Vermont credit through line 9 | |
| vtNonresidentEstimatedPayments | No | Form IN-111 line 26e: nonresident estimated tax payments (nonresident withholding) allocated on Schedule K-1VT line 30 | |
| wvSpouseIncomeNotOnLines35to46 | No | WV Schedule M line 47 box (c) column B (defaults to $8,000) | |
| hiChildRestraintSystemPurchased | No | HI line 31: bought one or more new child passenger restraint systems in 2025 — $25 per return (attach the invoice) | |
| hiFoodExciseQualifiedExemptions | No | HI Form N-311 line 8 override: qualified exemptions (persons, not the age-65 extra) plus public-agency-supported minor children — defaults to yourself + spouse (when claimed on line 6b) + dependents + hiPublicSupportMinorChildren | |
| idDependentCareBenefitsExcluded | No | ID Form 39R child care worksheet line 3: excluded dependent care benefits (Form 2441 Part III) | |
| nmNonQualifyingHouseholdMembers | No | NM PIT-RC line 2a: household members who do not qualify for the LICTR (nonresident dependents; a spouse not present six months) | |
| nmSpouseRebateExemptionsClaimed | No | NM PIT-RC line 2h (married filing separately only): the household members and extra exemptions your spouse already claimed on the spouse's PIT-RC line 2g — subtracted so each exemption is claimed once | |
| vaItemizedPersonalPropertyTaxes | No | VA Sch A line 5c personal property taxes — NOT subject to the SALT cap for Virginia | |
| vaItemizedStateLocalIncomeTaxes | No | VA Sch A line 5a when INCOME taxes are claimed (mutually exclusive with sales taxes) | |
| deSpouseAdditionalDeductionBoxes | No | COLUMN A: boxes checked for the spouse being 65 or over and/or blind — $2,500 each | |
| deSpouseEligibleRetirementIncome | No | COLUMN A: the spouse's eligible retirement income (60 or over only) | |
| deSpouseQualifiesElderlyDisabled | No | Form PIT-RES line 11 worksheet: the spouse was at least 60 or totally and permanently disabled — the $4,000 joint tier requires BOTH spouses to qualify | |
| deSpouseTuitionAbleContributions | No | COLUMN A: the spouse's DE529 and Delaware ABLE contributions | |
| hiCapitalGainsStatutoryThreshold | No | HI capital gains worksheet line 12: apply § 235-51(f)(1)(B)'s statutory amount under the 2025 brackets ($48,000 / $72,000 / $96,000) instead of the printed $24,000 / $36,000 / $48,000 — an election to disclose | |
| meAdultCareQualifyingIndividuals | No | ME adult dependent care: qualifying individuals (1 → $3,000 cap; 2+ → $6,000); defaults to 1 | |
| mtFederalNetLongTermCapitalGains | No | Schedule III Part II line 13: federal net long-term capital gains — the denominator of the capital gains block's Montana ratio | |
| mtMilitaryRetireeWithinFiveYears | No | MCA 15-30-2120(9)(b): the subtraction is within the five consecutive years allowed after first qualifying (unattested → no subtraction) | |
| mtOrdinaryIncomeSourcedToMontana | No | Schedule III Part II line 3: income sourced and taxable to Montana excluding net long-term capital gains (full-year residents: federal Form 1040 line 9 excluding those gains, less related expenses) | |
| nmArmedForcesRetirementPaySpouse | No | NM PIT-ADJ line 24: the spouse's armed forces retirement pay (MFJ) — its own $30,000 | |
| wvSpousePersTrsFederalRetirement | No | WV Schedule M line 33 column B (spouse), capped at $2,000 | |
| wvTaxpayerIncomeNotOnLines35to46 | No | WV Schedule M line 47 box (c) column A: the taxpayer's income not reported on lines 35-46 (defaults to $8,000, the cap) | |
| idFirstTimeHomeBuyerContributions | No | ID Form 39R Part B line 22: first-time home buyer savings account contributions plus interest — capped at $15,000 ($30,000 MFJ) | |
| idHealthPremiumsDeductedElsewhere | No | ID health worksheet line 9: health insurance costs deducted elsewhere on the federal return (self-employed health insurance) | |
| riSocialSecurityBenefitsFraPerson | No | RI Social Security Modification Worksheet line 9: the part of line 6a attributable to the person born on or before 03/01/1959 — only needed on a joint return where ONE spouse qualifies; defaults to the full line 6a (percentage 1.0000) | |
| wvFederalLawEnforcementRetirement | No | WV Schedule M line 30 column A: retired federal law enforcement officer / firefighter retirement benefits (100%) | |
| arDevelopmentallyDisabledDependents | No | AR1000TC line 7: dependents with a certified developmental disability (AR1000-DD on file) — $500 each | |
| wvHouseholdIncomeLessSocialSecurity | No | WV SCTC / HEPTC: income excluding Social Security when not required to file federally | |
| deSpouseDomiciledForPensionExclusion | No | COLUMN A / joint spouse: the spouse has been legally domiciled in Delaware for at least three years (TY2026+ 60-or-over pension exclusion gate) | |
| vtSelfEmploymentIncomeOutsideVermont | No | Form IN-111 line 21 worksheet line 2: the part of Schedule SE line 6 earned for work performed outside Vermont | |
| vtStudentLoanInterestDeductedFederally | No | Schedule IN-112 line 16b: student loan interest already deducted on federal Schedule 1 line 21 | |
| wvSpouseFederalLawEnforcementRetirement | No | WV Schedule M line 30 column B (spouse) |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears the full burden — and it delivers exceptionally. It discloses refusals ('the composer refuses without it' for MT/NM/ND/SC), forfeitures ('the Act 15 SB-16 retirement subtraction FORFEITS every credit — the composer enforces the forfeiture'), caps ('phases out by CT AGI, and limits to line 10'), prorations, rounding, and even future-year behavior ('TY2026 refuses at line 4 until the 2026 standard deduction publishes'). No contradiction with annotations exists.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The structure is well front-loaded (purpose in sentence one, workflow near the top) and follows a consistent per-jurisdiction pattern that aids scanning. However, at several thousand words the description is not concise by any standard; each state's paragraph duplicate the REQUIRED/refusal messaging and the per-state bases already implicit in the parameter names. Given 31 jurisdictions the length is partly justified, but it cannot score higher on conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Against the extreme complexity — 1015 parameters, 31 jurisdictions, no annotations, and no output schema — the description is remarkably complete: it specifies each state's income base (class-based vs AGI vs federal taxable income), required inputs, refusal conditions, exclusions of non-composed schedules, and the overall workflow. No output schema exists, yet the description still addresses the return format ('report its line set VERBATIM', 'whole-dollar rounding'). Little an agent needs is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already documents each of the 1015 parameters — the baseline is 3. The description adds real cross-parameter semantics the schema cannot convey: which params are REQUIRED per state, the routing relationships ('never also put it in nonrefundableCredits' for SC EITC; 'do NOT fold it into the generic subtractions total' for taxableSocialSecurity), and which inputs drive which composer behaviors. This is meaningful added value beyond per-field documentation, though it does not explain every one of the 1015 fields.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The opening sentence states the specific verb ('Compose'), resource ('a STATE return's printed-form line set'), and determinism of the operation, then enumerates all 31 jurisdictions and forms by name. This unambiguously distinguishes it from siblings like compute_return (the federal substrate) and calculate_tax; the scope is fully specified.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The 'Workflow:' passage is explicit about prerequisites ('run compute_return first for the federal substrate'), ordering ('then call this ONCE'), and what NOT to do ('Never hand-assemble state line numbers'). It names the alternative tool directly and gives when-not-to-use exclusions ('Maryland part-year returns... are not composed', 'Schedule ND-1NR... not composed', 'The Renter Credit... and Property Tax Credit... are separate claims'). This is the gold standard for usage routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Determine whether ONE candidate person is the taxpayer's § 152 dependent — qualifying child or qualifying relative, including multiple-support agreements and the divorced-parents release — as a proof-backed yes/no with citations. Feed the result into calculate_tax's credits group (qualifyingChildren / otherDependents).
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | REQUIRED for computation: the law-in-force date — use the intended tax year's year-end (e.g. "2025-12-31" for TY2025). Omitting it is an error, never a default. | |
| depAge | No | Candidate's age at the end of the year (§ 152(c)(3)). | |
| target | No | rule to derive (default: us.federal.dependent.is_dependent). Other targets: us.federal.dependent.qualifying_child, us.federal.dependent.qualifying_relative | |
| includeProof | No | include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned. | |
| depGrossIncome | No | Candidate's gross income for the year (§ 152(d)(1)(B) limit: $5,200 TY2025 / $5,300 TY2026). In dollars. | |
| depFilesJointReturn | No | Candidate files a joint return with a spouse (other than a refund-only claim) (§ 152(c)(1)(E)). | |
| depIsFullTimeStudent | No | Candidate was a full-time student for at least 5 months (§ 152(f)(2)). | |
| depRelationshipChild | No | Candidate is the taxpayer's child, stepchild, foster child, sibling, step-sibling, or a descendant of any of them (§ 152(c)(2)). | |
| depDivorcedParentsRule | No | § 152(e) applies to the candidate child: the parents are divorced, separated, or lived apart the last 6 months of the year; the child received over half their support from the parents and was in their custody over half the year. | |
| depPermanentlyDisabled | No | Candidate is permanently and totally disabled (§ 152(c)(3)(B)). | |
| depYoungerThanTaxpayer | No | Candidate is younger than the taxpayer (§ 152(c)(3)(A)). | |
| depRelationshipRelative | No | Candidate bears a § 152(d)(2) relationship to the taxpayer (parent, grandparent, sibling, in-law, etc.) or lived in the household all year. | |
| taxpayerIsCustodialParent | No | The taxpayer is the custodial parent (the parent with whom the child resided the greater number of nights, § 152(e)(4)(A)). | |
| hasMultipleSupportAgreement | No | A § 152(d)(3) multiple-support agreement is in place for the candidate: the group together provided over half the support, no one person provided over half, each member could otherwise claim the candidate, and every other over-10% contributor signed a Form 2120 waiver. | |
| custodialParentReleasedClaim | No | The custodial parent signed a written declaration (Form 8332) releasing the claim to the child for this year (§ 152(e)(2)). | |
| depIsQualifyingChildOfAnother | No | Candidate is the qualifying child of the taxpayer or any other taxpayer (§ 152(d)(1)(D)). | |
| depProvidedOwnSupportOverHalf | No | Candidate provided more than half of their own support (§ 152(c)(1)(D)). | |
| taxpayerProvidedOverHalfSupport | No | The taxpayer provided more than half of the candidate's support (§ 152(d)(1)(C)). | |
| depLivedWithTaxpayerOverHalfYear | No | Candidate had the same principal residence as the taxpayer for more than half the year (§ 152(c)(1)(B)). | |
| taxpayerProvidedOver10PercentSupport | No | The taxpayer contributed over 10 percent of the candidate's support (§ 152(d)(3)(D) — the support test under a multiple-support agreement). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the behavioral disclosure burden. It does disclose that the tool returns a proof-backed yes/no with citations and covers special scenarios like multiple-support agreements and the divorced-parents release. However, it does not describe side-effect behavior, failure modes, the relationship between hashes and proof output, or the mandatory asOf requirement, leaving notable gaps for a computation tool with no annotation safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences with no filler. The core scope, legal sub-rules, output type, and downstream integration are all packed into a tight front-loaded structure. Every clause contributes either selection-relevant or invocation-relevant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 20-parameter legal analysis tool with no output schema, the description is quite complete: it states the decision question, the applicable § 152 categories, the proof-backed result, and how to route the result into calculate_tax. The only noticeable gap is the absence of explicit return-shape detail beyond 'yes/no with citations', but given 100% parameter schema coverage and no siblings that overlap directly, this is a minor omission.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3 even though the tool description adds no per-parameter explanations. The description adds high-level legal context (multiple-support agreements, divorced-parents release) that clarifies why certain booleans matter, but the schema already documents every parameter, so no extra parameter meaning is needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description begins with a specific verb ('Determine'), a precise resource ('ONE candidate person is the taxpayer's § 152 dependent'), and clear sub-scopes ('qualifying child or qualifying relative, including multiple-support agreements and the divorced-parents release'). It also states the output type ('proof-backed yes/no with citations'), which uniquely distinguishes it from sibling tools like calculate_tax, verify_fact, and explain_rule.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear context: it should be used to evaluate one candidate dependent and its result feeds into calculate_tax's credits group (qualifyingChildren / otherDependents). It does not explicitly state when-not-to-use or name a specific alternative sibling for exclusions, so it stops just short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Get a tax rule's statutory citation, verbatim excerpt, validity window, parameters, and dependencies. Use to quote the actual law behind an answer.
| Name | Required | Description | Default |
|---|---|---|---|
| ruleId | Yes | e.g. "us.federal.standard_deduction" — list via calculate_tax proof or corpus |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It fully discloses the return fields (citation, excerpt, validity window, parameters, dependencies), which implies a read-only, non-destructive operation. It does not mention prerequisites or side effects, but given the tool's explanatory nature, this is acceptable.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise at two sentences. The first sentence front-loads the purpose and outputs, and the second provides the usage context. No extraneous information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the low complexity (1 required parameter, no output schema, no enums, no nesting), the description adequately covers the tool's purpose, outputs, and use case. It does not mention error conditions, but that is not necessary for a straightforward explanatory tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema coverage is 100% with a helpful description for ruleId (example value and source). The description adds value by explaining what the tool returns, which helps the agent understand how the parameter contributes to the output. Since coverage is high, the description meaningfully supplements the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states what the tool does: 'Get a tax rule's statutory citation, verbatim excerpt, validity window, parameters, and dependencies.' It also specifies the use case: 'Use to quote the actual law behind an answer.' This distinguishes it from siblings like search_tax_rules (finding rules) and calculate_tax (computing taxes).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides a clear context for when to use the tool ('to quote the actual law behind an answer'), but does not explicitly mention when not to use it or compare with siblings. However, the context is sufficient for an agent to infer appropriate usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Find exact dollar amounts where one more cent of an input costs MORE than a cent of tax (marginal rate over 100%) — e.g. the EITC investment-income kill switch, CTC phase-out steps. Every probe is a real evaluation.
| Name | Required | Description | Default |
|---|---|---|---|
| vary | Yes | money fact to vary, e.g. "wages" or "taxableInterest" | |
| facts | Yes | facts for the computation: either flat corpus fact ids (see list_input_facts) or the same group objects calculate_tax accepts (filing, income, retirement, …), plus optional target and asOf. Business/fiduciary/dependent facts are accepted flat. Unknown keys are rejected by name — nothing is ever silently dropped. | |
| toDollars | Yes | ||
| fromDollars | Yes | ||
| stepDollars | No | coarse scan step, default 1000 |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided. The description mentions 'every probe is a real evaluation,' suggesting actual tax calculations, but does not disclose performance, side effects, authentication needs, or rate limits. Lacks rich behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with a parenthetical, no fluff, and front-loads the core purpose. Every word adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema and moderate complexity, the description fails to explain what the tool returns, how the facts object is structured, or the scanning logic beyond 'real evaluation.' Incomplete for agent to invoke correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 60%, but the tool description adds no additional meaning beyond schema. The parameters (vary, facts, fromDollars, toDollars, stepDollars) are not elaborated. For example, stepDollars default is only in schema. Description does not compensate for uncovered parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool finds exact dollar amounts where marginal tax rate exceeds 100% (tax cliffs), with specific examples like EITC and CTC. It distinctively identifies unique functionality among siblings, which are mostly calculation or fact tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for finding tax cliffs but provides no explicit guidance on when to use or avoid this tool versus alternatives like calculate_tax or search_tax_rules. No when-not-to guidelines.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Determine whether a job is on the Treasury Tipped Occupation list (Treas. Reg. § 1.224-1, final Apr 2026) for the § 224 'no tax on tips' deduction. Fuzzy-matches the job name; returns the official listing (name, TTC code, category) or a definitive 'not listed'.
| Name | Required | Description | Default |
|---|---|---|---|
| job | Yes | e.g. "bartender", "software engineer", "DJ" |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses the fuzzy-matching nature and the return value (official listing or 'not listed'). It does not mention side effects or permissions, but as a read-only query, this is acceptable.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two concise sentences. It front-loads the purpose and regulatory reference, then details the behavior. No wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the low complexity (one parameter, no output schema), the description is complete. It explains the input and output sufficiently. No additional context like rate limits is expected for such a tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers 100% of parameters with examples. The description adds value by explaining fuzzy matching on the job name, which goes beyond the schema's static description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function: checking if a job is on the Treasury Tipped Occupation list for the §224 deduction. It specifies the regulation, the fuzzy-matching behavior, and the output format, distinguishing it from sibling tools that focus on calculations or other lookups.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explains when to use the tool (to determine tip deduction eligibility) and implies it's a lookup. It does not explicitly mention when not to use it or list alternatives, but the context of sibling tools provides implicit guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Discover every input the tax corpus understands: id, type, whether required, and its documented default. Call this if unsure what information to collect from the user.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It describes the output as listing inputs, which is clear, but does not disclose potential side effects, authentication needs, or performance considerations. For a read-only listing, this is adequate but not thorough.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences: first defines purpose and output, second gives usage guidance. No redundant or vague language. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has no parameters and no output schema, but the description fully explains its function and return contents. It tells the agent to use it for user data collection, providing complete context for a simple listing tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are zero parameters, so baseline is 4. The description adds meaning by specifying what attributes are returned (id, type, required, default), which helps the agent understand the tool's output beyond the empty schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool discovers every input the tax corpus understands, listing specific attributes (id, type, required, default). This distinguishes it from sibling tools that calculate, verify, or search.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly advises to call this when unsure what information to collect from the user, providing a direct usage context. It could be improved by mentioning when not to use it, but the guidance is strong.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Look up the current-law dollar amounts behind a question ('standard deduction', 'CTC phase-out threshold', 'tips deduction cap') with their statutory citations and validity windows. Use this to fact-check ANY tax number before stating it — your training data likely predates the OBBBA.
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | ||
| query | Yes | plain-English search, e.g. 'standard deduction' |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description discloses that it returns current-law amounts, statutory citations, and validity windows. It also warns about outdated training data, which is helpful. It does not mention error handling or read-only nature, but the intended behavior is clear.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences: the first clearly defines purpose and output, the second provides usage guidance. Every sentence is valuable and there is no redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple lookup tool with 2 parameters and no output schema, the description covers what it returns (citations, windows) and when to use it. It lacks details on what happens for missing queries or the exact format of citations, but it is largely sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 50% (query has description, asOf only has pattern). The description adds value by explaining query as 'plain-English search' with an example. However, the asOf parameter lacks semantic explanation beyond the date pattern, leaving ambiguity.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool looks up current-law dollar amounts behind specific tax questions, provides examples like 'standard deduction' and 'CTC phase-out threshold', and explicitly says it returns statutory citations and validity windows. This distinguishes it from sibling tools like verify_fact or search_tax_rules.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly advises to 'fact-check ANY tax number before stating it' because training data may be outdated. It implies the primary use case but does not explicitly mention when not to use it or alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Full-text search over the encoded tax-law corpus ('kiddie tax', 'NIIT threshold', 'california renters credit'). Returns matching rules: id, title, statutory citation, effective window, and a verbatim excerpt of the law text. A hit means the engine computes this; zero hits means it is outside the corpus — say so rather than guessing. Follow up with explain_rule for a hit's full formula, or lookup_tax_parameter for its dollar amounts.
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | ||
| limit | No | ||
| query | Yes | plain-English search, e.g. 'kiddie tax' |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description effectively conveys the read-only search behavior, what a hit means, and the return format. However, it does not mention any rate limits, authentication needs, or performance characteristics, leaving minor gaps in behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two succinct sentences followed by a single directive sentence. All information is front-loaded and relevant, with no wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (3 parameters, no output schema), the description provides sufficient context: purpose, return fields, interpretation of results, and links to sibling tools. It is complete enough for an agent to use correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 33% (only query described). The description adds a plain-English example for the query parameter but does not clarify the purpose or format of asOf and limit. The baseline compensation is minimal, leaving these parameters under-documented.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it performs full-text search over a tax-law corpus, provides example queries, and details the return fields (id, title, citation, window, excerpt). It distinguishes itself from sibling tools by specifying follow-up tools like explain_rule.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly tells the agent to interpret zero hits as meaning the query is outside the corpus and not to guess. Also directs to use explain_rule or lookup_tax_parameter for further details, providing clear actionable guidance on when to use which tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Fact-check a claimed dollar amount about tax law ('the 2026 MFJ standard deduction is $32,200', 'CTC is $2,000 per child') against the corpus. Returns verified / refuted (with the correct value and citation) / unknown. Never states a verdict it cannot ground.
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | ||
| query | Yes | what the amount is, e.g. 'standard deduction' | |
| filingStatus | No | ||
| claimedAmount | Yes | dollars, e.g. 50000 or "1234.56" |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It clearly states return values (verified/refuted with correct value and citation, unknown) and the grounding constraint, providing good transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences with no wasted words. Front-loaded with verb and resource, then return types and behavioral rule. Efficient and to the point.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Tool has 4 params, no output schema. Description explains purpose, output types, and a behavioral rule. Missing details on optional parameters (asOf, filingStatus) and how they affect results, leaving some gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 50% (2 of 4 params have descriptions). The description adds no extra meaning to parameters like 'asOf' or 'filingStatus' beyond examples. It does not compensate for missing schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool fact-checks a claimed dollar amount about tax law, with examples. It distinguishes from sibling 'verify_tax_claim' but not explicitly, and is specific about the resource.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for fact-checking dollar amounts but lacks explicit when-to-use or alternatives. It includes a behavioral rule ('Never states a verdict it cannot ground') but no guidance on when not to use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Verify a claimed tax amount (yours, a user's, or another tool's) against the law. Returns verdict 'verified' or 'refuted' with the correct value. Use this as a self-check before presenting any tax number. Put asOf (and target, if any) INSIDE the facts object — e.g. facts: {..., "asOf": "2025-12-31"} — otherwise the claim is checked under today's law.
| Name | Required | Description | Default |
|---|---|---|---|
| facts | Yes | facts for the computation: either flat corpus fact ids (see list_input_facts) or the same group objects calculate_tax accepts (filing, income, retirement, …), plus optional target and asOf. Business/fiduciary/dependent facts are accepted flat. Unknown keys are rejected by name — nothing is ever silently dropped. | |
| claimedAmount | Yes | the amount to verify (negative = refund) | |
| toleranceDollars | No | default 1 |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It discloses the return values (verdict and correct value), the fact that unknown keys are rejected (not silently dropped), and implies that without 'asOf', the law as of today is used. This is sufficient for safe invocation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very concise: two sentences and a usage note. Every sentence adds value, and the critical placement rule is front-loaded. No redundant or vague phrasing.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (3 params, nested objects, 14 siblings), the description covers purpose, usage, parameter semantics, and behavioral constraints. It lacks details on error handling or invalid facts, but overall is sufficient for an agent to use the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, baseline 3. The description adds meaning beyond schema: explains that 'facts' can be flat IDs or group objects, notes 'negative = refund' for claimedAmount, and gives default toleranceDollars=1. It also clarifies that 'asOf' and 'target' must be inside facts, enhancing parameter understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function: 'Verify a claimed tax amount against the law.' It explicitly specifies the return values ('verified' or 'refuted' with correct value) and distinguishes itself from sibling tools like verify_fact by targeting tax claims specifically. The scope (yours, a user's, or another tool's) is also clarified.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly advises: 'Use this as a self-check before presenting any tax number,' providing clear context. It also gives critical placement instructions for 'asOf' and 'target' inside the facts object. However, it does not explicitly state when not to use this tool or compare it to alternatives like verify_fact.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
calculate_tax2 fields changedInput schema / properties / documents / properties / w2s / items / properties / box4Added value: +{
+ "$ref": "#/properties/documents/properties/w2s/items/properties/box2",
+ "description": "social security tax withheld — recorded and summed; the Schedule 3 line 11 excess-withholding credit (several employers over the wage-base maximum) is NOT computed, a note flags it when the total exceeds the year's maximum"
+}Input schema / properties / strictAdded value: +{
+ "description": "strict mode for completed returns: if any transcribed document omits a box the return depends on (e.g. W-2 box 2 federal withholding), refuse with NEEDS_FACTS naming the box instead of treating it as $0. Default false — the $0 assumption is disclosed in documentNotes.",
+ "type": "boolean"
+}compute_return2 fields changedInput schema / properties / documents / properties / w2s / items / properties / box4Added value: +{
+ "$ref": "#/properties/documents/properties/w2s/items/properties/box2",
+ "description": "social security tax withheld — recorded and summed; the Schedule 3 line 11 excess-withholding credit (several employers over the wage-base maximum) is NOT computed, a note flags it when the total exceeds the year's maximum"
+}Input schema / properties / strictAdded value: +{
+ "description": "strict mode for completed returns: if any transcribed document omits a box the return depends on (e.g. W-2 box 2 federal withholding), refuse with NEEDS_FACTS naming the box instead of treating it as $0. Default false — the $0 assumption is disclosed in documentNotes.",
+ "type": "boolean"
+}calculate_business_tax1 field changedInput schema / properties / includeProofAdded value: +{
+ "description": "include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned.",
+ "type": "boolean"
+}calculate_fiduciary_tax1 field changedInput schema / properties / includeProofAdded value: +{
+ "description": "include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned.",
+ "type": "boolean"
+}calculate_tax1 field changedInput schema / properties / includeProofAdded value: +{
+ "description": "include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned.",
+ "type": "boolean"
+}compute_return1 field changedInput schema / properties / includeProofAdded value: +{
+ "description": "include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned.",
+ "type": "boolean"
+}determine_dependent1 field changedInput schema / properties / includeProofAdded value: +{
+ "description": "include the full proof artifact in the response as `proof` (PROOF-FORMAT v2: every applied rule, input, assumption and rounding, verifiable offline against corpusMerkleRoot; ~200 KB). Default false — the hashes alone are returned.",
+ "type": "boolean"
+}calculate_tax168 fields changedInput schema / properties / documents / properties / f1099rs / items / properties / rolledOver / descriptionPrevious value: -"interview-confirmed full rollover (e.g. 'distributions less rollovers = 0') — excluded from taxable income regardless of box 2a"New value: +"interview-confirmed full rollover (e.g. 'distributions less rollovers = 0') — excluded from taxable income regardless of box 2a. NOT for a code-G direct rollover to a ROTH: the payer reports the converted amount in box 2a and it IS taxable"Input schema / properties / documents / properties / selfEmploymentEarnerAdded value: +{
+ "description": "who earned the self-employment income (Schedule C / 1099-NEC / 1099-K) — defaults to the taxpayer; on a joint return this selects whose W-2 box 3 feeds Schedule SE line 8a",
+ "enum": [
+ "taxpayer",
+ "spouse"
+ ],
+ "type": "string"
+}Input schema / properties / documents / properties / w2s / items / properties / recipientAdded value: +{
+ "description": "whose W-2 this is (box e) — REQUIRED on a joint return with self-employment income, because Schedule SE line 8a coordinates the wage base with the SE earner's OWN box 3 only",
+ "enum": [
+ "taxpayer",
+ "spouse"
+ ],
+ "type": "string"
+}Input schema / properties / filing / properties / mfsLivedApartAllYear / descriptionPrevious value: -"MFS filer lived apart from the spouse AT ALL TIMES during the year — § 469(i)(5) (halves the special allowance to $12,500/$50,000; living together at any time = NO allowance) AND § 219(g)(4) (an MFS filer who lived apart all year is NOT treated as married for the IRA-deduction phaseout: the single ranges apply and no spousal-coverage attribution occurs)."New value: +"MFS filer lived apart from the spouse AT ALL TIMES during the year — § 469(i)(5) (halves the special allowance to $12,500/$50,000; living together at any time = NO allowance) AND § 219(g)(4) (an MFS filer who lived apart all year is NOT treated as married for the IRA-deduction phaseout: the single ranges apply and no spousal-coverage attribution occurs) AND § 86(c)(1)(C)(ii) (the $0 social-security base amount applies only to an MFS filer who did NOT live apart all year; one who did uses the $25,000/$34,000 unmarried amounts)."Input schema / properties / income / properties / otherEarnedIncomeAdded value: +{
+ "description": "Form 1040 lines 1b-1h earned income NOT on a W-2 box 1 — taxable dependent care benefits (Form 2441 Part III, line 26 → line 1e), household employee wages without a W-2 (1b), unreported tips (1c), Medicaid waiver payments elected in (1d), nonqualified deferred compensation (1g). Added to wages (earned income); reported on line 1h. Allowed together with a documents block.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / income / properties / socialSecurityWagesProvidedAdded value: +{
+ "description": "socialSecurityWages is an EXPLICIT figure for the self-employment earner — set it (with socialSecurityWages, even $0) when that person's own W-2 box 3 is known, so Schedule SE line 8a uses it instead of falling back to box-1 wages. The documents compiler sets it from W-2 recipients; a joint return where the SE earner has no W-2 needs it with socialSecurityWages 0 (us.federal.se_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deAdditionalDeductionBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form PIT-RES line 21: the number of boxes checked for age 65 or over and blindness — $2,500 each, maximum two boxes ($5,000) per person. Four boxes are possible on a joint return, and on a married-filing-separate return (status 3) when the spouse's boxes qualify under 30 Del. C. § 1108(b)(2)/(4): that spouse is 65 or over or blind, has NO gross income, and is not another taxpayer's dependent. Two boxes for every other status, and per column of a combined separate return. Not allowed with itemized deductions (us.de.standard_deduction)."
+}Input schema / properties / state / properties / deAdjustedGrossIncomeAdded value: +{
+ "description": "Form PIT-RES line 12: Delaware adjusted gross income — the denominator of the other-state credit ratio (us.de.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deAge60OrOverAdded value: +{
+ "description": "Form PIT-RES line 6: the person claiming the pension exclusion was 60 or over on December 31 of the tax year — the 60-or-over tier allows $12,500 of pension PLUS eligible retirement income, while under 60 allows only $2,000 of pension (us.de.pension_exclusion).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deAge60PersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form PIT-RES line 27b: the number of persons 60 or over on December 31 (you and/or your spouse) — an additional $110 each (us.de.personal_credits)."
+}Input schema / properties / state / properties / deAgiBeforeExclusionAdded value: +{
+ "description": "Form PIT-RES line 10: adjusted gross income after the Section B subtractions but BEFORE the line 11 exclusion — the statutory 'adjusted gross income (without reduction by this exclusion)' income test (us.de.elderly_disabled_exclusion). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deDomiciledForPensionExclusionAdded value: +{
+ "description": "TY2026 and after: the person claiming the 60-or-over pension exclusion has been legally domiciled in Delaware (a 'resident individual' under 30 Del. C. § 1103) for at least three years — 30 Del. C. § 1106(b)(3)f.4, added by 85 Del. Laws c. 426 effective August 17, 2026. A 60-or-over person who does not meet it gets NO pension exclusion at all, not the under-60 tier (us.de.pension_exclusion version 2). Not needed for TY2025.",
+ "type": "boolean"
+}Input schema / properties / state / properties / deEarnedIncomeAdded value: +{
+ "description": "Form PIT-RES line 11 worksheet: earned income (wages, tips, farm or business income) — must be under $2,500, or under $5,000 on a joint return, for the elderly/disabled exclusion (us.de.elderly_disabled_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deEitcTaxAfterCreditsAdded value: +{
+ "description": "DE Schedule II line 12: Form PIT-RES line 33 — the Delaware tax after ALL other non-refundable credits, which decides which earned income credit branch applies (us.de.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deEligibleRetirementIncomeAdded value: +{
+ "description": "Form PIT-RES line 6, 60-or-over worksheet: eligible retirement income — dividends, capital gains net of losses, interest, net rental income from real property, and qualified retirement plan distributions (IRA, 401(k), Keogh, and IRC 457 government deferred compensation). Counts ONLY for a person 60 or over (us.de.pension_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form PIT-RES line 27a: the number of federal exemptions (yourself, your spouse on a joint return, and dependents) — $110 each. A childless joint return enters 2 (us.de.personal_credits)."
+}Input schema / properties / state / properties / deFederalChildCareCreditAdded value: +{
+ "description": "Form PIT-RES line 31 worksheet: the federal child and dependent care credit from federal Form 2441 line 11. Delaware allows 50% of it, capped at $3,000 and at the tax (us.de.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deFederalEicAdded value: +{
+ "description": "DE Schedule II line 13: the federal earned income credit from federal Form 1040 line 27. Delaware allows either 20% limited to the tax or 4.5% fully refundable (us.de.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deIncomeTaxAdded value: +{
+ "description": "Form PIT-RES line 24: the Delaware tax before credits, which the other-state credit ratio is applied to (us.de.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deItemizesAdded value: +{
+ "description": "Form PIT-RES line 20b: itemizing Delaware deductions instead of the standard deduction. Delaware's election is INDEPENDENT of the federal one, but it disallows the line 21 additional standard deduction entirely (us.de.standard_deduction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deMilitaryPensionAdded value: +{
+ "description": "Form PIT-RES line 6 checkbox: the pension is a United States military pension — raises the UNDER-60 exclusion from $2,000 to $12,500. Since 84 Del. Laws c. 437 the definition covers the Army, Navy, Air Force, Marine Corps, Space Force, Coast Guard, the NOAA and Public Health Service commissioned corps, and the National Guard (us.de.pension_exclusion).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deOtherStateIncomeAdded value: +{
+ "description": "Other-state credit worksheet line 1: adjusted gross income from the other state's return. The ratio to Delaware AGI is capped at 100% (us.de.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deOtherStateTaxPaidAdded value: +{
+ "description": "Other-state credit worksheet line 6: income tax paid to the other state net of its credits. EXCLUDES city and county taxes; the District of Columbia counts as a state (us.de.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / dePensionIncomeAdded value: +{
+ "description": "Form PIT-RES line 6: amounts received as pensions from employers, the United States, this State or its subdivisions. Excludes early distributions (1099-R box 7 code 1, or an early-withdrawal penalty) and employer-paid disability pension income before minimum retirement age (us.de.pension_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deQualifiesElderlyDisabledAdded value: +{
+ "description": "Form PIT-RES line 11 worksheet: you were at least 60 years old OR totally and permanently disabled on December 31 (us.de.elderly_disabled_exclusion).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deSpouseQualifiesElderlyDisabledAdded value: +{
+ "description": "Form PIT-RES line 11 worksheet: your spouse was at least 60 years old OR totally and permanently disabled on December 31 — the $4,000 joint tier requires BOTH spouses to qualify (us.de.elderly_disabled_exclusion).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deUseRateScheduleAdded value: +{
+ "description": "Form PIT-RES line 24: compute from the rate schedule at the exact taxable income instead of the printed Tax Table (taxable income under $60,000 uses the table's row midpoint by instruction; $60,000 or more always uses the schedule) (us.de.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deVolunteerFirefightersAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form PIT-RES line 29: the number of qualifying active volunteer firefighters or members of a volunteer fire company auxiliary, ambulance or rescue squad on the return (0, 1 or 2) — $1,000 each. The Division verifies this credit before processing, so it defaults to none (us.de.volunteer_firefighter_credit)."
+}Input schema / properties / state / properties / hiAdjustedTaxLiabilityAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 19: Form N-11 line 34 adjusted tax liability (us.hi.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiAgiAdded value: +{
+ "description": "Hawaii adjusted gross income, Form N-11 line 20 — the medical, casualty, and miscellaneous floors and the overall limitation (us.hi.itemized_deductions), the renters credit AGI test (us.hi.renters_credit), and the child care percentage (us.hi.child_dependent_care_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiCapitalGainsStatutoryThresholdAdded value: +{
+ "description": "Tax on Capital Gains Worksheet line 12: use HRS § 235-51(f)(1)(B)'s 'taxable income taxed at a rate below 7.25 per cent' under the 2025 brackets ($48,000 single/MFS, $72,000 HOH, $96,000 MFJ/QSS) instead of the printed $24,000 / $36,000 / $48,000 (us.hi.capital_gains_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / hiCasualtyLossesAdded value: +{
+ "description": "Worksheet A-5 line 19: casualty and theft losses after the $100-per-casualty reduction, before the 10% floor (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiCharitableContributionsAdded value: +{
+ "description": "Worksheet A-4 line 18: gifts to charity (cash, other, carryover) within the AGI limits (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiChildCareExpensesAdded value: +{
+ "description": "Schedule X line 20/22: qualified child and dependent care expenses paid in 2025 (before the $10,000 / $20,000 cap) (us.hi.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiChildCareQualifyingPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule X line 17: qualifying persons (1 → $10,000 cap; 2 or more → $20,000) (us.hi.child_dependent_care_credit)."
+}Input schema / properties / state / properties / hiDependentCareBenefitsAdded value: +{
+ "description": "Schedule X line 18: deductible and excluded dependent care benefits (lines 14 + 15) that reduce the expense cap (us.hi.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiDisabledPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form N-11 line 25 ovals: taxpayers (you and/or your spouse) claiming the $7,000 blind, deaf, or totally disabled exemption in lieu of all regular exemptions (Form N-172 certified) (us.hi.personal_exemption)."
+}Input schema / properties / state / properties / hiEarnedIncomeAdded value: +{
+ "description": "Earned income (wages, salaries, tips, professional fees, taxable scholarships, net business and farm income less the SE tax deduction) — the dependent-filer standard deduction (us.hi.standard_deduction) and Schedule X line 23 (us.hi.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form N-11 line 6e: total exemptions (yourself, spouse, dependents, plus one more for each taxpayer or spouse 65 or older) — $1,144 each (us.hi.personal_exemption)."
+}Input schema / properties / state / properties / hiFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form N-11 line 7 — the state income/sales tax deduction gate (us.hi.itemized_deductions) and the food/excise credit table (us.hi.food_excise_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiFederalEicAdded value: +{
+ "description": "Form N-356 line 2: the federal earned income credit claimed on the federal return (Form 1040 line 27a) — 40% (us.hi.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiFoodExciseQualifiedExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form N-311 line 8: qualified exemptions — yourself, spouse, and dependents present in Hawaii more than nine months and not claimable by another (not the extra age-65 exemption), plus minor children supported by public agencies (us.hi.food_excise_credit)."
+}Input schema / properties / state / properties / hiGamblingLossesInMiscAdded value: +{
+ "description": "Total Itemized Deductions Worksheet line 2d: gambling and casualty or theft losses included in Worksheet A-6 line 30 — protected from the overall limitation (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiHomeMortgageInterestAdded value: +{
+ "description": "Worksheet A-3 lines 10-12: home mortgage interest and points (pre-TCJA limits) (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiInvestmentInterestAdded value: +{
+ "description": "Worksheet A-3 line 13: investment interest from Form N-158 — protected from the overall limitation (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiInvestmentInterestN158Added value: +{
+ "description": "Tax on Capital Gains Worksheet line 9: Form N-158 line 4e — net capital gain elected as investment income (us.hi.capital_gains_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiJobAndMiscExpensesAdded value: +{
+ "description": "Worksheet A-6 line 26: unreimbursed employee business expenses, tax preparation fees, and other expenses subject to the 2% floor (us.hi.itemized_deductions; ignored for TY2026). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiMedicalExpensesAdded value: +{
+ "description": "Worksheet A-1 line 1: medical and dental expenses before the 7.5% floor (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiMfsConsideredUnmarriedAdded value: +{
+ "description": "Schedule X Part II checkbox: a married-filing-separately filer who lived apart from the spouse the last six months, kept the qualifying person's home, and paid over half its cost (us.hi.child_dependent_care_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / hiNetCapitalGainAdded value: +{
+ "description": "Tax on Capital Gains Worksheet line 7: Hawaii net capital gain (federal Schedule D line 16 plus Hawaii adjustments) (us.hi.capital_gains_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiNetCapitalGainLine27aAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 2: the net capital gain beside Form N-11 line 27a (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiNetLongTermCapitalGainAdded value: +{
+ "description": "Tax on Capital Gains Worksheet line 4: Hawaii net long-term capital gain (federal Schedule D line 15 plus Hawaii long-term adjustments) (us.hi.capital_gains_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiNonDisabledSpouseAge65Added value: +{
+ "description": "With one disabled spouse on a joint return, the non-disabled spouse is 65 or older — $9,288 instead of $8,144 (us.hi.personal_exemption).",
+ "type": "boolean"
+}Input schema / properties / state / properties / hiOtherMiscDeductionsAdded value: +{
+ "description": "Worksheet A-6 line 30: other deductions not subject to the 2% limit (gambling losses to the extent of winnings, impairment-related work expenses) (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiOtherStateTaxEligibleAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 9: tax paid to other states plus foreign tax not credited federally (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiOtherTaxesAdded value: +{
+ "description": "Worksheet A-2 line 8: other deductible taxes (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiOutOfStateIncomeAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 3: out-of-state income including capital gains, excluding Hawaii-exempt income (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiOutOfStateLtcgAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 4: long-term capital gains from sources outside Hawaii (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiPersonalPropertyTaxesAdded value: +{
+ "description": "Worksheet A-2 line 7: personal property taxes paid to other states (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiRealEstateTaxesAdded value: +{
+ "description": "Worksheet A-2 line 6: real estate taxes (no foreign real property taxes) (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiRentPaidAdded value: +{
+ "description": "Schedule X line 7: rent paid in 2025 for the Hawaii residence (not exempt from real property tax) net of utilities, parking, ground rent, and subsidies — must exceed $1,000 (us.hi.renters_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiRentersExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule X line 11: qualified exemptions (yourself, spouse, dependents present more than nine months and not claimable by another) plus one more for you and one for your spouse if 65 or older — $50 each (us.hi.renters_credit)."
+}Input schema / properties / state / properties / hiReservePayAdded value: +{
+ "description": "Form N-11 line 15: the taxpayer's military reserve or Hawaii National Guard duty pay (W-2 Box 16 from the reserve component) — the first $8,636 is excluded (us.hi.reserve_pay_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiSpouseAgiAdded value: +{
+ "description": "Schedule X Part I: the spouse's Hawaii adjusted gross income, added for married filing separately (us.hi.renters_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiSpouseEarnedIncomeAdded value: +{
+ "description": "Schedule X line 24: the spouse's earned income on a joint return (or the $200 / $400 monthly deemed amount for a student or disabled spouse) (us.hi.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiSpouseFederalAgiAdded value: +{
+ "description": "Form N-311 line 5: the spouse's federal AGI, added for married filing separately (us.hi.food_excise_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiSpouseReservePayAdded value: +{
+ "description": "Form N-11 line 15: the spouse's reserve or National Guard duty pay on a joint return (us.hi.reserve_pay_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiStateLocalIncomeTaxesAdded value: +{
+ "description": "Worksheet A-2 line 5: state and local income taxes (or the elected general sales taxes) — allowed only when federal AGI is under $100,000 single/MFS, $150,000 HOH, $200,000 MFJ/QSS; exclude amounts claimed under the other-state credit (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiTaxLine13Added value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 13: the Form N-11 line 27 tax from the table, schedule, or capital gains worksheet (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiUseRateScheduleAdded value: +{
+ "description": "Compute Form N-11 line 27 from the Tax Rate Schedules at the exact income instead of the Tax Table (taxable income under $100,000 uses the table's $50-row midpoint by default; $100,000 or more always uses the schedules) (us.hi.income_tax, us.hi.capital_gains_tax, us.hi.other_state_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtAbleContributionsAdded value: +{
+ "description": "Schedule I line 17: contributions to an Achieving a Better Life Experience (ABLE) account — up to $3,000, or $6,000 on a joint return (us.mt.able_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtAge62Added value: +{
+ "description": "Schedule 2EC eligibility: the claimant reached age 62 by December 31 of the tax year (us.mt.elderly_homeowner_renter_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtCapitalGainsTaxAdded value: +{
+ "description": "Schedule III Part II line 15: Montana net long-term capital gains tax from Form 2 page 2 line 11 — the base the other-state credit's capital gains block is limited by (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtFederalEicAdded value: +{
+ "description": "Form 2 line 15: the federal earned income credit from federal Form 1040 line 27 — Montana allows 10% of it for 2025, 20% from 2026, refundable (us.mt.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtFederalNetLongTermCapitalGainsAdded value: +{
+ "description": "Schedule III Part II line 13: federal net long-term capital gains — the denominator of the capital gains block's second ratio (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtGrossHouseholdIncomeAdded value: +{
+ "description": "Schedule 2EC line 18: GROSS household income — all income of ALL household members, taxable and non-taxable, including the full amount of pensions and annuities, Railroad Retirement and veterans' disability benefits, excluded capital gains, alimony, support money, cash public assistance, tax-exempt interest, all Social Security, and refundable credits received in cash (expressly including the 2024 Montana property tax rebate). This is NOT federal AGI. Must be under $45,000 (us.mt.elderly_homeowner_renter_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtMilitaryRetireeEligibleAdded value: +{
+ "description": "MCA 15-30-2120(9)(a): the military retiree either became a Montana resident on or after June 30, 2023, or was a resident before receiving the pension and remained one after (us.mt.military_retirement_subtraction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtMilitaryRetireeWithinFiveYearsAdded value: +{
+ "description": "MCA 15-30-2120(9)(b): the subtraction is being claimed within the five consecutive years allowed after first qualifying (us.mt.military_retirement_subtraction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtMilitaryRetirementIncomeAdded value: +{
+ "description": "Schedule I line 13: military pension, military retirement income, or military survivor benefits (Form WMRE) — the subtraction is the LESSER of Montana source wage income or 50% of this amount (us.mt.military_retirement_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtMontanaSourceWageIncomeAdded value: +{
+ "description": "MCA 15-30-2120(8)(b): Montana source wage income — the cap on the military retirement subtraction. The statute defines it as wages, salary, tips and other compensation for services performed in Montana PLUS net income from a trade, business, profession or occupation carried on in Montana PLUS net income from Montana farming, so Schedule C and F net income count; a fully retired veteran with none of the three gets nothing (us.mt.military_retirement_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtNetLongTermCapitalGainsAdded value: +{
+ "description": "Form 2 page 2 line 2: net long-term capital gains subject to the federal net long-term capital gains tax — generally the LESSER of federal Schedule D line 15 or line 16 (us.mt.income_tax, us.mt.capital_gains_tax). Montana taxes these at 3% / 4.1%; qualified dividends are NOT included (they are Montana ordinary income). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOccupied6MonthsAdded value: +{
+ "description": "Schedule 2EC eligibility: the claimant occupied a Montana residence as an owner, renter or lessee for at least six months during the tax year (us.mt.elderly_homeowner_renter_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtOrdinaryIncomeSourcedToMontanaAdded value: +{
+ "description": "Schedule III Part II line 3: income sourced and taxable to Montana excluding net long-term capital gains (full-year residents: federal Form 1040 line 9 excluding net long-term capital gains, less related expenses) — the denominator of the second ratio (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOrdinaryIncomeTaxAdded value: +{
+ "description": "Schedule III Part II line 5: Montana ordinary income tax from Form 2 page 2 line 12 — the base the other-state credit's ordinary block is limited by (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOtherStateCapitalGainsAdded value: +{
+ "description": "Schedule III Part II line 11: net long-term capital gain sourced and taxable to the other state or country and included in Montana taxable income (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOtherStateOrdinaryIncomeAdded value: +{
+ "description": "Schedule III Part II line 1: income sourced and taxable to the other state or country that is included in Montana taxable income, EXCLUDING net long-term capital gains (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOtherStateTaxPaidAdded value: +{
+ "description": "Schedule III Part II lines 4 AND 14: the TOTAL income tax liability actually paid to the other state or country, excluding penalties and interest (us.mt.other_state_credit). The same figure feeds both blocks — the line 16 ratio attributes the capital-gains share; do not pre-attribute. North Dakota WAGES are not eligible (reciprocity); foreign tax is not eligible if a federal Form 1116 credit was claimed. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOtherStateTotalIncomeAdded value: +{
+ "description": "Schedule III Part II lines 2 and 12: ALL income sourced and taxable to the other state or country — the denominator of the first ratio (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtPropertyTaxBilledAdded value: +{
+ "description": "Schedule 2EC line 23: property tax billed on the Montana residence and up to one acre, including special assessments and fees but excluding penalties and interest (us.mt.elderly_homeowner_renter_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtRentPaidAdded value: +{
+ "description": "Schedule 2EC line 24: rent paid in the tax year for the Montana residence — 15% of it is the rent-equivalent tax paid. Excludes mortgage payments, nursing home costs paid directly from Social Security, and rent paid by a rental assistance program (us.mt.elderly_homeowner_renter_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtResided9MonthsAdded value: +{
+ "description": "Schedule 2EC eligibility: the claimant resided in Montana for at least nine months during the tax year (us.mt.elderly_homeowner_renter_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtSoleHouseholdClaimantAdded value: +{
+ "description": "Schedule 2EC attestation: 'I am the only member of my household claiming this credit' — only one elderly homeowner/renter credit is allowed per household (us.mt.elderly_homeowner_renter_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtSpouseAge65Added value: +{
+ "description": "Form 2 line 6: your spouse attained age 65 — a second $5,660 subtraction, on a JOINT return only (us.mt.age65_subtraction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtTaxpayerAge65Added value: +{
+ "description": "Form 2 line 6: you attained age 65 — a $5,660 subtraction from federal taxable income for 2025 (us.mt.age65_subtraction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtTuitionSavingsContributionsAdded value: +{
+ "description": "Schedule I line 16: contributions to a Montana family education savings (section 529) account — up to $4,500, or $9,000 on a joint return, for 2025 (us.mt.tuition_savings_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndCapitalGainAlreadyExcludedAdded value: +{
+ "description": "Net long-term capital gain worksheet line 6: the portion of that gain already included in an amount entered on Form ND-1 line 7 (exempt Native American income) or line 16 (Schedule ND-1SA subtractions), which is not eligible for the 40% exclusion (us.nd.capital_gain_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndCollegeSaveContributionsAdded value: +{
+ "description": "Form ND-1 line 12: contributions to a North Dakota College SAVE account administered by the Bank of North Dakota — capped at $5,000, or $10,000 on a joint return. Rollovers from another section 529 plan do NOT qualify (us.nd.college_save_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndDoublyTaxedIncomeAdded value: +{
+ "description": "Schedule ND-1CR line 1c: the part of federal AGI sourced to the other state that was received or earned while a North Dakota resident — the numerator of the four-decimal ratio (us.nd.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndIncomeTaxBeforeCreditsAdded value: +{
+ "description": "Schedule ND-1CR line 4: the North Dakota tax from Form ND-1 line 20, which the ratio is applied to (us.nd.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndJointScheduleTaxAdded value: +{
+ "description": "Marriage Penalty Credit Worksheet line 10: the tax on WORKSHEET LINE 1 — the couple's Form ND-1 line 18 taxable income, NOT their qualified income — computed on the MARRIED FILING JOINTLY rate schedule (us.nd.marriage_penalty_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndLowerQualifiedIncomeAdded value: +{
+ "description": "Marriage Penalty Credit Worksheet: the qualified income of the LOWER-earning spouse, which must exceed $47,550 for 2025 (us.nd.marriage_penalty_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndNetLongTermCapitalGainAdded value: +{
+ "description": "Net long-term capital gain worksheet line 3: the SMALLER of federal Schedule D lines 15 and 16 — or, when no Schedule D was required, the capital gain distributions from Form 1040 line 7. The worksheet stops outright if either Schedule D figure is zero or less, so a net loss yields no exclusion (us.nd.capital_gain_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndOtherStateIncomeBaseAdded value: +{
+ "description": "Schedule ND-1CR line 2: for a full-year resident, federal AGI (Form ND-1 line 1a) LESS the line 5 United States obligation interest — the denominator of the ratio (us.nd.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndOtherStateTaxPaidAdded value: +{
+ "description": "Schedule ND-1CR line 6: the NET income tax shown on the other state's return — after that state's credits but before its withholding and estimated payments — plus any local jurisdiction tax in that same state. Foreign countries do not qualify, and Montana and Minnesota WAGES are excluded by reciprocity (us.nd.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndQualifiedDividendsAdded value: +{
+ "description": "Form ND-1 line 13: qualified dividends from federal Form 1040 or 1040-SR line 3a — North Dakota excludes 40%. A part-year resident or nonresident uses the portion reported to North Dakota (us.nd.qualified_dividend_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndSingleScheduleTaxAAdded value: +{
+ "description": "Marriage Penalty Credit Worksheet line 7: the tax on WORKSHEET LINE 6 computed on the SINGLE rate schedule (us.nd.marriage_penalty_credit). Line 6 is the lower-earning spouse's qualified income MINUS the worksheet's preprinted $15,750 (half the federal joint standard deduction) — the rule takes this line as a computed amount and does NOT subtract the $15,750 itself, so a caller supplying the tax on the unreduced income overstates the credit. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndSingleScheduleTaxBAdded value: +{
+ "description": "Marriage Penalty Credit Worksheet line 9: the tax on WORKSHEET LINE 8 computed on the SINGLE rate schedule (us.nd.marriage_penalty_credit). Line 8 is Form ND-1 line 18 taxable income MINUS that same worksheet line 6 amount (the lower-earning spouse's qualified income less the preprinted $15,750). The rule takes this line as a computed amount and performs neither subtraction itself. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndTaxableIncomeAdded value: +{
+ "description": "Form ND-1 line 18: North Dakota taxable income — the marriage penalty credit requires it to exceed $81,036 for 2025 (us.nd.marriage_penalty_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndUseRateScheduleAdded value: +{
+ "description": "Form ND-1 line 20: compute from the rate schedule at the exact taxable income instead of the printed Tax Table (taxable income under $100,000 uses the table's $50-row midpoint, which section 57-38-30.3(10) makes mandatory; $100,000 or more always uses the schedule) (us.nd.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riAge65OrDisabledAdded value: +{
+ "description": "Form RI-1040H Part 1 question D: you or your spouse were 65 or older, or receiving Social Security disability benefits, as of December 31, 2025 — plus domicile for the whole year and current taxes/rent (us.ri.property_tax_relief_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "RI Schedule E line 5: total exemptions — yourself (unless claimable by another), your spouse on a joint return, and dependents — $5,100 each (us.ri.exemption)."
+}Input schema / properties / state / properties / riFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form RI-1040 line 1 — the Social Security and pension modification income tests and the use tax lookup table (us.ri.social_security_modification, us.ri.pension_modification, us.ri.use_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riFederalChildCareCreditAdded value: +{
+ "description": "RI Schedule I line 20: the federal child and dependent care credit, Schedule 3 line 2 — 25% (us.ri.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riFederalEicAdded value: +{
+ "description": "RI Schedule EIC line 39: the federal earned income credit, Form 1040 line 27a — 16% (us.ri.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riHouseholdIncomeAdded value: +{
+ "description": "Form RI-1040H line 32: total 2025 household income of every household member, taxable and nontaxable, with losses added back (us.ri.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riHouseholdMembersAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form RI-1040H line 1f: persons in the household — the '1 person' or '2 or more' percentage column (us.ri.property_tax_relief_credit)."
+}Input schema / properties / state / properties / riIncomeTaxAdded value: +{
+ "description": "RI Schedule I line 19: Form RI-1040 line 8 income tax — the cap on the child care credit (us.ri.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riIncomeTaxAfterFederalCreditAdded value: +{
+ "description": "RI Schedule II line 23: line 8 income tax less the Schedule I line 22 credit (us.ri.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riLargePurchasesNetUseTaxAdded value: +{
+ "description": "RI Schedule U line 7e: net use tax due on single purchases of $1,000 or more (7% less sales tax paid) added to the lookup amount (us.ri.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riModifiedAgiAdded value: +{
+ "description": "Modified federal adjusted gross income, Form RI-1040 line 3 (federal AGI plus RI Schedule M net modifications) — the standard deduction and exemption phase-outs (us.ri.standard_deduction, us.ri.exemption) and the other-state credit ratio (us.ri.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riOtherStateIncomeAdded value: +{
+ "description": "RI Schedule II line 24: income derived from the other state (Form RI-1040MU line 29 for several states) (us.ri.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riOtherStateTaxPaidAdded value: +{
+ "description": "RI Schedule II line 28: income tax due and paid to the other state (not withholding; $0 if fully refunded) (us.ri.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riPropertyTaxPaidAdded value: +{
+ "description": "Form RI-1040H line 2: property taxes paid or payable for 2025 on the homestead (the owner's share) (us.ri.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riRentPaidAdded value: +{
+ "description": "Form RI-1040H line 7: rent paid in 2025 for occupancy only (net of utilities and furnishings), also rented land under a taxed home — 20% counts as property tax (us.ri.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riSalesTaxPaidOtherStatesAdded value: +{
+ "description": "RI Schedule U line 3: sales taxes paid in other states on the line 1 purchases (us.ri.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riSocialSecurityBenefitsAdded value: +{
+ "description": "Social Security Worksheet line 8: total Social Security benefits, Form 1040 line 6a (us.ri.social_security_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riSocialSecurityBenefitsFraPersonAdded value: +{
+ "description": "Social Security Worksheet line 9: the part of line 8 attributed to the spouse who has reached full retirement age when only one spouse has (us.ri.social_security_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riSpouseFullRetirementAgeAdded value: +{
+ "description": "The spouse has reached Social Security full retirement age — born on or before March 1, 1959 for 2025 (joint returns) (us.ri.social_security_modification, us.ri.pension_modification).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riSpousePensionIncomeAdded value: +{
+ "description": "Schedule M line 1t table line 2 column (b): the spouse's taxable pension and annuity income on a joint return (us.ri.pension_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riTaxableSocialSecurityAdded value: +{
+ "description": "Social Security Worksheet line 11: taxable Social Security, Form 1040 line 6b (us.ri.social_security_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riTaxpayerFullRetirementAgeAdded value: +{
+ "description": "The taxpayer has reached Social Security full retirement age — born on or before March 1, 1959 for 2025 (Social Security Worksheet line 5; Schedule M line 1t question 1) (us.ri.social_security_modification, us.ri.pension_modification).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riTaxpayerPensionIncomeAdded value: +{
+ "description": "Schedule M line 1t table line 2 column (a): the taxpayer's federally taxable pension and annuity income (Form 1040 line 5b), not IRA distributions or military service pensions (us.ri.pension_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riUseRateScheduleAdded value: +{
+ "description": "Compute Form RI-1040 line 8 with the Tax Computation Worksheet arithmetic at the exact income instead of the Tax Table (taxable income under $100,000 uses the table's $50-row midpoint by default; $100,000 or more always uses the worksheet) (us.ri.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riUseTaxLookupTableAdded value: +{
+ "description": "RI Schedule U Option #2: use the safe-harbor lookup table on federal AGI instead of actual purchases (us.ri.use_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riUseTaxPurchasesAdded value: +{
+ "description": "RI Schedule U line 1: total price of purchases subject to use tax — 7% (us.ri.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtAdditionalDeductionBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form IN-111 line 4: the number of standard deduction boxes checked on federal Form 1040 (born before January 2, 1961, or blind) — $1,250 each; the chart allows at most two for single and head of household and four for the 'Married Filing Jointly or Qualifying Widow(er)' row and for married filing separately (us.vt.standard_deduction)."
+}Input schema / properties / state / properties / vtCharitableContributionsAdded value: +{
+ "description": "Form IN-111 line 11: charitable contributions allowable under IRC § 170, whether or not itemized federally — the credit is 5% of the first $20,000 (us.vt.charitable_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtChildrenSixOrUnderAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule IN-112 Part II line 3: number of qualifying children (IRC § 152(c)) who were six years of age or younger at the close of the calendar year — born 2019 through 2025 for tax year 2025 — $1,000 each before the AGI phase-out (us.vt.child_tax_credit)."
+}Input schema / properties / state / properties / vtContributorySystemIncomeAdded value: +{
+ "description": "Retirement Income Exemption Worksheet line 11: income received from the Civil Service Retirement System or another contributory system of the U.S., Vermont or another state based on earnings NOT covered by Social Security — the first $10,000 is excludable on the same AGI thresholds as Social Security, when that election is made (us.vt.retirement_income_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtEitcQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule IN-112 Part II line 5: number of qualifying children from federal Schedule EIC — one or more makes the Vermont credit 38% of the federal credit; none makes it 100% (us.vt.eitc)."
+}Input schema / properties / state / properties / vtEligibleLongTermGainAdded value: +{
+ "description": "Schedule IN-153 Part II line 17: net adjusted capital gain from assets held MORE than three years, excluding gain on a primary or nonprimary residence, depreciable personal property (other than farm property and standing timber), and publicly traded stocks, bonds and financial instruments, less allocated investment interest — 40% is excludable up to $350,000 (us.vt.capital_gains_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form IN-111 line 5d: total personal exemptions — 1 for yourself unless someone can claim you, 1 for a spouse on a joint return only (NOT a qualifying widow(er) or married filing separately), plus other dependents (us.vt.personal_exemption)."
+}Input schema / properties / state / properties / vtFederalAgiAdded value: +{
+ "description": "Form IN-111 line 1: federal adjusted gross income — the base for the 3% minimum tax above $150,000, the retirement and military exclusion phase-outs, the child tax credit and veteran credit phase-outs, the student loan interest limit and the estimated use tax table (us.vt.income_tax and the Vermont credit and exclusion rules). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtFederalChildCareCreditAdded value: +{
+ "description": "Schedule IN-112 Part II line 1: the federal child and dependent care credit from Form 2441 line 11 — Vermont allows 72%, refundable (us.vt.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtFederalEicAdded value: +{
+ "description": "Schedule IN-112 Part II line 6: the federal earned income credit from Form 1040 — Vermont allows 38% with qualifying children, 100% without (us.vt.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtFederalTaxAdjustmentBaseAdded value: +{
+ "description": "Schedule IN-119 Part I line 4 (federal tax on qualified plans and tax-favored accounts, investment credit recapture, Form 4972 lump-sum tax) or Part II line 11 (federal credit for the elderly or disabled, Vermont-based investment credit, farm income averaging) — 24% of it is the Vermont adjustment (us.vt.federal_tax_adjustment). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtFederalTaxableIncomeAdded value: +{
+ "description": "Schedule IN-153 line 20 base: federal taxable income (Form 1040 line 15) — the capital gains exclusion cannot exceed 40% of it (us.vt.capital_gains_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtIncomeTaxAdded value: +{
+ "description": "Schedule IN-117 line 18: Vermont income tax from Form IN-111 line 14 (after the charitable credit, before the income adjustment and credits) (us.vt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtMilitaryRetirementIncomeAdded value: +{
+ "description": "Schedule IN-112 line 13: federally taxable U.S. military retirement income and military survivor benefit income (federal Form 1040 line 5b, DFAS 1099-R) — excluded in full at federal AGI up to $125,000, phased out to $175,000, for every filing status (us.vt.military_retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtModifiedAgiAdded value: +{
+ "description": "Schedule IN-117 line 17: modified Vermont adjusted gross income — federal AGI plus Schedule IN-112 lines 3 and 4, less lines 7 and 9 (us.vt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtNetAdjustedCapitalGainAdded value: +{
+ "description": "Schedule IN-153 Part I line 8: net adjusted capital gain — the smaller of federal Schedule D lines 15 and 16, less qualified dividends and other ineligible amounts, less allocated investment interest expense; the base of the $5,000 flat exclusion. Zero when the federal return shows a net capital loss (us.vt.capital_gains_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtOtherStateIncomeAdded value: +{
+ "description": "Schedule IN-117 line 9: modified adjusted gross income taxed by the other state or Canadian province AND by Vermont — the AGI taxed there plus its bonus depreciation and non-Vermont obligation addbacks, less bonus depreciation and U.S. government interest subtracted there (us.vt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtOtherStateTaxPaidAdded value: +{
+ "description": "Schedule IN-117 line 20: income tax PAID to the other state or Canadian province on the line 9 income — not withholding, not city or county tax, and not the portion of Canadian tax taken as a federal foreign tax credit (us.vt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtRetirementElectionAdded value: +{
+ "description": "Schedule IN-112 line 12 election under 32 V.S.A. § 5830e(e)(1): exclude EITHER federally taxable Social Security ('social_security') OR up to $10,000 of Civil Service Retirement System / other non-Social-Security contributory system income ('contributory_system'); only one may be elected (us.vt.retirement_income_exclusion).",
+ "enum": [
+ "none",
+ "social_security",
+ "contributory_system"
+ ],
+ "type": "string"
+}Input schema / properties / state / properties / vtSelfEmploymentIncomeAdded value: +{
+ "description": "Child Care Contribution Worksheet line 1: net earnings from self-employment, federal Schedule SE line 6 (us.vt.child_care_contribution). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtSelfEmploymentIncomeOutsideVermontAdded value: +{
+ "description": "Child Care Contribution Worksheet line 2: the part of Schedule SE line 6 earned for work performed outside Vermont (us.vt.child_care_contribution). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtStudentLoanInterestDeductedFederallyAdded value: +{
+ "description": "Schedule IN-112 line 16b: student loan interest already deducted on federal Form 1040 Schedule 1 line 21 — only the excess is subtracted for Vermont (us.vt.student_loan_interest_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtStudentLoanInterestPaidAdded value: +{
+ "description": "Schedule IN-112 line 16a: total interest paid in the year on qualified student loans (us.vt.student_loan_interest_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtTaxableSocialSecurityAdded value: +{
+ "description": "Federal Form 1040 line 6b: federally taxable Social Security benefits — excluded in full at federal AGI up to $55,000 ($70,000 joint), phased out to $65,000 ($80,000 joint), when the Social Security election is made (us.vt.retirement_income_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtUsObligationInterestAdded value: +{
+ "description": "Schedule IN-112 Part I line 7: interest income from U.S. government obligations — subtracted from federal AGI before the 3% minimum tax is figured, per the Form IN-111 line 8 instruction (us.vt.income_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtUseRateScheduleAdded value: +{
+ "description": "Form IN-111 line 8: apply the rate schedule at the exact taxable income instead of the printed Tax Table (taxable income under $75,000 uses the $100-row midpoint; 'TAXABLE INCOME UNDER $75,000 USE THE TAX TABLES') (us.vt.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / vtUseTaxEstimateFromTableAdded value: +{
+ "description": "Use Tax Worksheet Part 1: the filer did NOT keep records of untaxed purchases under $1,000 and uses the Estimated Use Tax Table on federal AGI instead of 6% of recorded purchases (us.vt.use_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / vtUseTaxLargePurchasesAdded value: +{
+ "description": "Use Tax Worksheet line 3a: total untaxed purchases of items $1,000 or more each — always reported item by item, even when the table estimates the small purchases (us.vt.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtUseTaxPaidOtherStateAdded value: +{
+ "description": "Use Tax Worksheet line 3d: sales tax paid to another state on the purchases reported on lines 2a and 3a (us.vt.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtUseTaxSmallPurchasesAdded value: +{
+ "description": "Use Tax Worksheet line 2a: total untaxed purchases of items under $1,000 each, from records (us.vt.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtVeteranDischargeRecordAdded value: +{
+ "description": "Schedule IN-112 Part II lines 8-12: the filer has a discharge record or other record of separation from active duty verifying service in the uniformed services — the eligibility condition for the $250 veteran credit under 32 V.S.A. § 5830g(b) (us.vt.veteran_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / vtVheipBeneficiariesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule IN-119 Part II line 1: the number of VHEIP account beneficiaries contributed for — each carries its own $2,500 ($5,000 joint) contribution cap (us.vt.vheip_credit)."
+}Input schema / properties / state / properties / vtVheipContributionsAdded value: +{
+ "description": "Schedule IN-119 Part II line 1: contributions during the year to Vermont Higher Education Investment Plan (VHEIP / VT529) accounts — the credit is 10% of the first $2,500 per beneficiary ($5,000 on a joint return) (us.vt.vheip_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return168 fields changedInput schema / properties / documents / properties / f1099rs / items / properties / rolledOver / descriptionPrevious value: -"interview-confirmed full rollover (e.g. 'distributions less rollovers = 0') — excluded from taxable income regardless of box 2a"New value: +"interview-confirmed full rollover (e.g. 'distributions less rollovers = 0') — excluded from taxable income regardless of box 2a. NOT for a code-G direct rollover to a ROTH: the payer reports the converted amount in box 2a and it IS taxable"Input schema / properties / documents / properties / selfEmploymentEarnerAdded value: +{
+ "description": "who earned the self-employment income (Schedule C / 1099-NEC / 1099-K) — defaults to the taxpayer; on a joint return this selects whose W-2 box 3 feeds Schedule SE line 8a",
+ "enum": [
+ "taxpayer",
+ "spouse"
+ ],
+ "type": "string"
+}Input schema / properties / documents / properties / w2s / items / properties / recipientAdded value: +{
+ "description": "whose W-2 this is (box e) — REQUIRED on a joint return with self-employment income, because Schedule SE line 8a coordinates the wage base with the SE earner's OWN box 3 only",
+ "enum": [
+ "taxpayer",
+ "spouse"
+ ],
+ "type": "string"
+}Input schema / properties / filing / properties / mfsLivedApartAllYear / descriptionPrevious value: -"MFS filer lived apart from the spouse AT ALL TIMES during the year — § 469(i)(5) (halves the special allowance to $12,500/$50,000; living together at any time = NO allowance) AND § 219(g)(4) (an MFS filer who lived apart all year is NOT treated as married for the IRA-deduction phaseout: the single ranges apply and no spousal-coverage attribution occurs)."New value: +"MFS filer lived apart from the spouse AT ALL TIMES during the year — § 469(i)(5) (halves the special allowance to $12,500/$50,000; living together at any time = NO allowance) AND § 219(g)(4) (an MFS filer who lived apart all year is NOT treated as married for the IRA-deduction phaseout: the single ranges apply and no spousal-coverage attribution occurs) AND § 86(c)(1)(C)(ii) (the $0 social-security base amount applies only to an MFS filer who did NOT live apart all year; one who did uses the $25,000/$34,000 unmarried amounts)."Input schema / properties / income / properties / otherEarnedIncomeAdded value: +{
+ "description": "Form 1040 lines 1b-1h earned income NOT on a W-2 box 1 — taxable dependent care benefits (Form 2441 Part III, line 26 → line 1e), household employee wages without a W-2 (1b), unreported tips (1c), Medicaid waiver payments elected in (1d), nonqualified deferred compensation (1g). Added to wages (earned income); reported on line 1h. Allowed together with a documents block.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / income / properties / socialSecurityWagesProvidedAdded value: +{
+ "description": "socialSecurityWages is an EXPLICIT figure for the self-employment earner — set it (with socialSecurityWages, even $0) when that person's own W-2 box 3 is known, so Schedule SE line 8a uses it instead of falling back to box-1 wages. The documents compiler sets it from W-2 recipients; a joint return where the SE earner has no W-2 needs it with socialSecurityWages 0 (us.federal.se_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deAdditionalDeductionBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form PIT-RES line 21: the number of boxes checked for age 65 or over and blindness — $2,500 each, maximum two boxes ($5,000) per person. Four boxes are possible on a joint return, and on a married-filing-separate return (status 3) when the spouse's boxes qualify under 30 Del. C. § 1108(b)(2)/(4): that spouse is 65 or over or blind, has NO gross income, and is not another taxpayer's dependent. Two boxes for every other status, and per column of a combined separate return. Not allowed with itemized deductions (us.de.standard_deduction)."
+}Input schema / properties / state / properties / deAdjustedGrossIncomeAdded value: +{
+ "description": "Form PIT-RES line 12: Delaware adjusted gross income — the denominator of the other-state credit ratio (us.de.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deAge60OrOverAdded value: +{
+ "description": "Form PIT-RES line 6: the person claiming the pension exclusion was 60 or over on December 31 of the tax year — the 60-or-over tier allows $12,500 of pension PLUS eligible retirement income, while under 60 allows only $2,000 of pension (us.de.pension_exclusion).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deAge60PersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form PIT-RES line 27b: the number of persons 60 or over on December 31 (you and/or your spouse) — an additional $110 each (us.de.personal_credits)."
+}Input schema / properties / state / properties / deAgiBeforeExclusionAdded value: +{
+ "description": "Form PIT-RES line 10: adjusted gross income after the Section B subtractions but BEFORE the line 11 exclusion — the statutory 'adjusted gross income (without reduction by this exclusion)' income test (us.de.elderly_disabled_exclusion). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deDomiciledForPensionExclusionAdded value: +{
+ "description": "TY2026 and after: the person claiming the 60-or-over pension exclusion has been legally domiciled in Delaware (a 'resident individual' under 30 Del. C. § 1103) for at least three years — 30 Del. C. § 1106(b)(3)f.4, added by 85 Del. Laws c. 426 effective August 17, 2026. A 60-or-over person who does not meet it gets NO pension exclusion at all, not the under-60 tier (us.de.pension_exclusion version 2). Not needed for TY2025.",
+ "type": "boolean"
+}Input schema / properties / state / properties / deEarnedIncomeAdded value: +{
+ "description": "Form PIT-RES line 11 worksheet: earned income (wages, tips, farm or business income) — must be under $2,500, or under $5,000 on a joint return, for the elderly/disabled exclusion (us.de.elderly_disabled_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deEitcTaxAfterCreditsAdded value: +{
+ "description": "DE Schedule II line 12: Form PIT-RES line 33 — the Delaware tax after ALL other non-refundable credits, which decides which earned income credit branch applies (us.de.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deEligibleRetirementIncomeAdded value: +{
+ "description": "Form PIT-RES line 6, 60-or-over worksheet: eligible retirement income — dividends, capital gains net of losses, interest, net rental income from real property, and qualified retirement plan distributions (IRA, 401(k), Keogh, and IRC 457 government deferred compensation). Counts ONLY for a person 60 or over (us.de.pension_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form PIT-RES line 27a: the number of federal exemptions (yourself, your spouse on a joint return, and dependents) — $110 each. A childless joint return enters 2 (us.de.personal_credits)."
+}Input schema / properties / state / properties / deFederalChildCareCreditAdded value: +{
+ "description": "Form PIT-RES line 31 worksheet: the federal child and dependent care credit from federal Form 2441 line 11. Delaware allows 50% of it, capped at $3,000 and at the tax (us.de.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deFederalEicAdded value: +{
+ "description": "DE Schedule II line 13: the federal earned income credit from federal Form 1040 line 27. Delaware allows either 20% limited to the tax or 4.5% fully refundable (us.de.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deIncomeTaxAdded value: +{
+ "description": "Form PIT-RES line 24: the Delaware tax before credits, which the other-state credit ratio is applied to (us.de.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deItemizesAdded value: +{
+ "description": "Form PIT-RES line 20b: itemizing Delaware deductions instead of the standard deduction. Delaware's election is INDEPENDENT of the federal one, but it disallows the line 21 additional standard deduction entirely (us.de.standard_deduction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deMilitaryPensionAdded value: +{
+ "description": "Form PIT-RES line 6 checkbox: the pension is a United States military pension — raises the UNDER-60 exclusion from $2,000 to $12,500. Since 84 Del. Laws c. 437 the definition covers the Army, Navy, Air Force, Marine Corps, Space Force, Coast Guard, the NOAA and Public Health Service commissioned corps, and the National Guard (us.de.pension_exclusion).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deOtherStateIncomeAdded value: +{
+ "description": "Other-state credit worksheet line 1: adjusted gross income from the other state's return. The ratio to Delaware AGI is capped at 100% (us.de.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deOtherStateTaxPaidAdded value: +{
+ "description": "Other-state credit worksheet line 6: income tax paid to the other state net of its credits. EXCLUDES city and county taxes; the District of Columbia counts as a state (us.de.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / dePensionIncomeAdded value: +{
+ "description": "Form PIT-RES line 6: amounts received as pensions from employers, the United States, this State or its subdivisions. Excludes early distributions (1099-R box 7 code 1, or an early-withdrawal penalty) and employer-paid disability pension income before minimum retirement age (us.de.pension_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / deQualifiesElderlyDisabledAdded value: +{
+ "description": "Form PIT-RES line 11 worksheet: you were at least 60 years old OR totally and permanently disabled on December 31 (us.de.elderly_disabled_exclusion).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deSpouseQualifiesElderlyDisabledAdded value: +{
+ "description": "Form PIT-RES line 11 worksheet: your spouse was at least 60 years old OR totally and permanently disabled on December 31 — the $4,000 joint tier requires BOTH spouses to qualify (us.de.elderly_disabled_exclusion).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deUseRateScheduleAdded value: +{
+ "description": "Form PIT-RES line 24: compute from the rate schedule at the exact taxable income instead of the printed Tax Table (taxable income under $60,000 uses the table's row midpoint by instruction; $60,000 or more always uses the schedule) (us.de.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / deVolunteerFirefightersAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form PIT-RES line 29: the number of qualifying active volunteer firefighters or members of a volunteer fire company auxiliary, ambulance or rescue squad on the return (0, 1 or 2) — $1,000 each. The Division verifies this credit before processing, so it defaults to none (us.de.volunteer_firefighter_credit)."
+}Input schema / properties / state / properties / hiAdjustedTaxLiabilityAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 19: Form N-11 line 34 adjusted tax liability (us.hi.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiAgiAdded value: +{
+ "description": "Hawaii adjusted gross income, Form N-11 line 20 — the medical, casualty, and miscellaneous floors and the overall limitation (us.hi.itemized_deductions), the renters credit AGI test (us.hi.renters_credit), and the child care percentage (us.hi.child_dependent_care_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiCapitalGainsStatutoryThresholdAdded value: +{
+ "description": "Tax on Capital Gains Worksheet line 12: use HRS § 235-51(f)(1)(B)'s 'taxable income taxed at a rate below 7.25 per cent' under the 2025 brackets ($48,000 single/MFS, $72,000 HOH, $96,000 MFJ/QSS) instead of the printed $24,000 / $36,000 / $48,000 (us.hi.capital_gains_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / hiCasualtyLossesAdded value: +{
+ "description": "Worksheet A-5 line 19: casualty and theft losses after the $100-per-casualty reduction, before the 10% floor (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiCharitableContributionsAdded value: +{
+ "description": "Worksheet A-4 line 18: gifts to charity (cash, other, carryover) within the AGI limits (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiChildCareExpensesAdded value: +{
+ "description": "Schedule X line 20/22: qualified child and dependent care expenses paid in 2025 (before the $10,000 / $20,000 cap) (us.hi.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiChildCareQualifyingPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule X line 17: qualifying persons (1 → $10,000 cap; 2 or more → $20,000) (us.hi.child_dependent_care_credit)."
+}Input schema / properties / state / properties / hiDependentCareBenefitsAdded value: +{
+ "description": "Schedule X line 18: deductible and excluded dependent care benefits (lines 14 + 15) that reduce the expense cap (us.hi.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiDisabledPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form N-11 line 25 ovals: taxpayers (you and/or your spouse) claiming the $7,000 blind, deaf, or totally disabled exemption in lieu of all regular exemptions (Form N-172 certified) (us.hi.personal_exemption)."
+}Input schema / properties / state / properties / hiEarnedIncomeAdded value: +{
+ "description": "Earned income (wages, salaries, tips, professional fees, taxable scholarships, net business and farm income less the SE tax deduction) — the dependent-filer standard deduction (us.hi.standard_deduction) and Schedule X line 23 (us.hi.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form N-11 line 6e: total exemptions (yourself, spouse, dependents, plus one more for each taxpayer or spouse 65 or older) — $1,144 each (us.hi.personal_exemption)."
+}Input schema / properties / state / properties / hiFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form N-11 line 7 — the state income/sales tax deduction gate (us.hi.itemized_deductions) and the food/excise credit table (us.hi.food_excise_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiFederalEicAdded value: +{
+ "description": "Form N-356 line 2: the federal earned income credit claimed on the federal return (Form 1040 line 27a) — 40% (us.hi.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiFoodExciseQualifiedExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form N-311 line 8: qualified exemptions — yourself, spouse, and dependents present in Hawaii more than nine months and not claimable by another (not the extra age-65 exemption), plus minor children supported by public agencies (us.hi.food_excise_credit)."
+}Input schema / properties / state / properties / hiGamblingLossesInMiscAdded value: +{
+ "description": "Total Itemized Deductions Worksheet line 2d: gambling and casualty or theft losses included in Worksheet A-6 line 30 — protected from the overall limitation (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiHomeMortgageInterestAdded value: +{
+ "description": "Worksheet A-3 lines 10-12: home mortgage interest and points (pre-TCJA limits) (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiInvestmentInterestAdded value: +{
+ "description": "Worksheet A-3 line 13: investment interest from Form N-158 — protected from the overall limitation (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiInvestmentInterestN158Added value: +{
+ "description": "Tax on Capital Gains Worksheet line 9: Form N-158 line 4e — net capital gain elected as investment income (us.hi.capital_gains_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiJobAndMiscExpensesAdded value: +{
+ "description": "Worksheet A-6 line 26: unreimbursed employee business expenses, tax preparation fees, and other expenses subject to the 2% floor (us.hi.itemized_deductions; ignored for TY2026). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiMedicalExpensesAdded value: +{
+ "description": "Worksheet A-1 line 1: medical and dental expenses before the 7.5% floor (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiMfsConsideredUnmarriedAdded value: +{
+ "description": "Schedule X Part II checkbox: a married-filing-separately filer who lived apart from the spouse the last six months, kept the qualifying person's home, and paid over half its cost (us.hi.child_dependent_care_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / hiNetCapitalGainAdded value: +{
+ "description": "Tax on Capital Gains Worksheet line 7: Hawaii net capital gain (federal Schedule D line 16 plus Hawaii adjustments) (us.hi.capital_gains_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiNetCapitalGainLine27aAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 2: the net capital gain beside Form N-11 line 27a (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiNetLongTermCapitalGainAdded value: +{
+ "description": "Tax on Capital Gains Worksheet line 4: Hawaii net long-term capital gain (federal Schedule D line 15 plus Hawaii long-term adjustments) (us.hi.capital_gains_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiNonDisabledSpouseAge65Added value: +{
+ "description": "With one disabled spouse on a joint return, the non-disabled spouse is 65 or older — $9,288 instead of $8,144 (us.hi.personal_exemption).",
+ "type": "boolean"
+}Input schema / properties / state / properties / hiOtherMiscDeductionsAdded value: +{
+ "description": "Worksheet A-6 line 30: other deductions not subject to the 2% limit (gambling losses to the extent of winnings, impairment-related work expenses) (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiOtherStateTaxEligibleAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 9: tax paid to other states plus foreign tax not credited federally (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiOtherTaxesAdded value: +{
+ "description": "Worksheet A-2 line 8: other deductible taxes (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiOutOfStateIncomeAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 3: out-of-state income including capital gains, excluding Hawaii-exempt income (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiOutOfStateLtcgAdded value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 4: long-term capital gains from sources outside Hawaii (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiPersonalPropertyTaxesAdded value: +{
+ "description": "Worksheet A-2 line 7: personal property taxes paid to other states (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiRealEstateTaxesAdded value: +{
+ "description": "Worksheet A-2 line 6: real estate taxes (no foreign real property taxes) (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiRentPaidAdded value: +{
+ "description": "Schedule X line 7: rent paid in 2025 for the Hawaii residence (not exempt from real property tax) net of utilities, parking, ground rent, and subsidies — must exceed $1,000 (us.hi.renters_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiRentersExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule X line 11: qualified exemptions (yourself, spouse, dependents present more than nine months and not claimable by another) plus one more for you and one for your spouse if 65 or older — $50 each (us.hi.renters_credit)."
+}Input schema / properties / state / properties / hiReservePayAdded value: +{
+ "description": "Form N-11 line 15: the taxpayer's military reserve or Hawaii National Guard duty pay (W-2 Box 16 from the reserve component) — the first $8,636 is excluded (us.hi.reserve_pay_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiSpouseAgiAdded value: +{
+ "description": "Schedule X Part I: the spouse's Hawaii adjusted gross income, added for married filing separately (us.hi.renters_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiSpouseEarnedIncomeAdded value: +{
+ "description": "Schedule X line 24: the spouse's earned income on a joint return (or the $200 / $400 monthly deemed amount for a student or disabled spouse) (us.hi.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiSpouseFederalAgiAdded value: +{
+ "description": "Form N-311 line 5: the spouse's federal AGI, added for married filing separately (us.hi.food_excise_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiSpouseReservePayAdded value: +{
+ "description": "Form N-11 line 15: the spouse's reserve or National Guard duty pay on a joint return (us.hi.reserve_pay_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiStateLocalIncomeTaxesAdded value: +{
+ "description": "Worksheet A-2 line 5: state and local income taxes (or the elected general sales taxes) — allowed only when federal AGI is under $100,000 single/MFS, $150,000 HOH, $200,000 MFJ/QSS; exclude amounts claimed under the other-state credit (us.hi.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiTaxLine13Added value: +{
+ "description": "Other State and Foreign Tax Credit Worksheet line 13: the Form N-11 line 27 tax from the table, schedule, or capital gains worksheet (us.hi.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / hiUseRateScheduleAdded value: +{
+ "description": "Compute Form N-11 line 27 from the Tax Rate Schedules at the exact income instead of the Tax Table (taxable income under $100,000 uses the table's $50-row midpoint by default; $100,000 or more always uses the schedules) (us.hi.income_tax, us.hi.capital_gains_tax, us.hi.other_state_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtAbleContributionsAdded value: +{
+ "description": "Schedule I line 17: contributions to an Achieving a Better Life Experience (ABLE) account — up to $3,000, or $6,000 on a joint return (us.mt.able_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtAge62Added value: +{
+ "description": "Schedule 2EC eligibility: the claimant reached age 62 by December 31 of the tax year (us.mt.elderly_homeowner_renter_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtCapitalGainsTaxAdded value: +{
+ "description": "Schedule III Part II line 15: Montana net long-term capital gains tax from Form 2 page 2 line 11 — the base the other-state credit's capital gains block is limited by (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtFederalEicAdded value: +{
+ "description": "Form 2 line 15: the federal earned income credit from federal Form 1040 line 27 — Montana allows 10% of it for 2025, 20% from 2026, refundable (us.mt.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtFederalNetLongTermCapitalGainsAdded value: +{
+ "description": "Schedule III Part II line 13: federal net long-term capital gains — the denominator of the capital gains block's second ratio (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtGrossHouseholdIncomeAdded value: +{
+ "description": "Schedule 2EC line 18: GROSS household income — all income of ALL household members, taxable and non-taxable, including the full amount of pensions and annuities, Railroad Retirement and veterans' disability benefits, excluded capital gains, alimony, support money, cash public assistance, tax-exempt interest, all Social Security, and refundable credits received in cash (expressly including the 2024 Montana property tax rebate). This is NOT federal AGI. Must be under $45,000 (us.mt.elderly_homeowner_renter_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtMilitaryRetireeEligibleAdded value: +{
+ "description": "MCA 15-30-2120(9)(a): the military retiree either became a Montana resident on or after June 30, 2023, or was a resident before receiving the pension and remained one after (us.mt.military_retirement_subtraction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtMilitaryRetireeWithinFiveYearsAdded value: +{
+ "description": "MCA 15-30-2120(9)(b): the subtraction is being claimed within the five consecutive years allowed after first qualifying (us.mt.military_retirement_subtraction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtMilitaryRetirementIncomeAdded value: +{
+ "description": "Schedule I line 13: military pension, military retirement income, or military survivor benefits (Form WMRE) — the subtraction is the LESSER of Montana source wage income or 50% of this amount (us.mt.military_retirement_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtMontanaSourceWageIncomeAdded value: +{
+ "description": "MCA 15-30-2120(8)(b): Montana source wage income — the cap on the military retirement subtraction. The statute defines it as wages, salary, tips and other compensation for services performed in Montana PLUS net income from a trade, business, profession or occupation carried on in Montana PLUS net income from Montana farming, so Schedule C and F net income count; a fully retired veteran with none of the three gets nothing (us.mt.military_retirement_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtNetLongTermCapitalGainsAdded value: +{
+ "description": "Form 2 page 2 line 2: net long-term capital gains subject to the federal net long-term capital gains tax — generally the LESSER of federal Schedule D line 15 or line 16 (us.mt.income_tax, us.mt.capital_gains_tax). Montana taxes these at 3% / 4.1%; qualified dividends are NOT included (they are Montana ordinary income). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOccupied6MonthsAdded value: +{
+ "description": "Schedule 2EC eligibility: the claimant occupied a Montana residence as an owner, renter or lessee for at least six months during the tax year (us.mt.elderly_homeowner_renter_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtOrdinaryIncomeSourcedToMontanaAdded value: +{
+ "description": "Schedule III Part II line 3: income sourced and taxable to Montana excluding net long-term capital gains (full-year residents: federal Form 1040 line 9 excluding net long-term capital gains, less related expenses) — the denominator of the second ratio (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOrdinaryIncomeTaxAdded value: +{
+ "description": "Schedule III Part II line 5: Montana ordinary income tax from Form 2 page 2 line 12 — the base the other-state credit's ordinary block is limited by (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOtherStateCapitalGainsAdded value: +{
+ "description": "Schedule III Part II line 11: net long-term capital gain sourced and taxable to the other state or country and included in Montana taxable income (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOtherStateOrdinaryIncomeAdded value: +{
+ "description": "Schedule III Part II line 1: income sourced and taxable to the other state or country that is included in Montana taxable income, EXCLUDING net long-term capital gains (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOtherStateTaxPaidAdded value: +{
+ "description": "Schedule III Part II lines 4 AND 14: the TOTAL income tax liability actually paid to the other state or country, excluding penalties and interest (us.mt.other_state_credit). The same figure feeds both blocks — the line 16 ratio attributes the capital-gains share; do not pre-attribute. North Dakota WAGES are not eligible (reciprocity); foreign tax is not eligible if a federal Form 1116 credit was claimed. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtOtherStateTotalIncomeAdded value: +{
+ "description": "Schedule III Part II lines 2 and 12: ALL income sourced and taxable to the other state or country — the denominator of the first ratio (us.mt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtPropertyTaxBilledAdded value: +{
+ "description": "Schedule 2EC line 23: property tax billed on the Montana residence and up to one acre, including special assessments and fees but excluding penalties and interest (us.mt.elderly_homeowner_renter_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtRentPaidAdded value: +{
+ "description": "Schedule 2EC line 24: rent paid in the tax year for the Montana residence — 15% of it is the rent-equivalent tax paid. Excludes mortgage payments, nursing home costs paid directly from Social Security, and rent paid by a rental assistance program (us.mt.elderly_homeowner_renter_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mtResided9MonthsAdded value: +{
+ "description": "Schedule 2EC eligibility: the claimant resided in Montana for at least nine months during the tax year (us.mt.elderly_homeowner_renter_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtSoleHouseholdClaimantAdded value: +{
+ "description": "Schedule 2EC attestation: 'I am the only member of my household claiming this credit' — only one elderly homeowner/renter credit is allowed per household (us.mt.elderly_homeowner_renter_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtSpouseAge65Added value: +{
+ "description": "Form 2 line 6: your spouse attained age 65 — a second $5,660 subtraction, on a JOINT return only (us.mt.age65_subtraction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtTaxpayerAge65Added value: +{
+ "description": "Form 2 line 6: you attained age 65 — a $5,660 subtraction from federal taxable income for 2025 (us.mt.age65_subtraction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mtTuitionSavingsContributionsAdded value: +{
+ "description": "Schedule I line 16: contributions to a Montana family education savings (section 529) account — up to $4,500, or $9,000 on a joint return, for 2025 (us.mt.tuition_savings_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndCapitalGainAlreadyExcludedAdded value: +{
+ "description": "Net long-term capital gain worksheet line 6: the portion of that gain already included in an amount entered on Form ND-1 line 7 (exempt Native American income) or line 16 (Schedule ND-1SA subtractions), which is not eligible for the 40% exclusion (us.nd.capital_gain_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndCollegeSaveContributionsAdded value: +{
+ "description": "Form ND-1 line 12: contributions to a North Dakota College SAVE account administered by the Bank of North Dakota — capped at $5,000, or $10,000 on a joint return. Rollovers from another section 529 plan do NOT qualify (us.nd.college_save_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndDoublyTaxedIncomeAdded value: +{
+ "description": "Schedule ND-1CR line 1c: the part of federal AGI sourced to the other state that was received or earned while a North Dakota resident — the numerator of the four-decimal ratio (us.nd.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndIncomeTaxBeforeCreditsAdded value: +{
+ "description": "Schedule ND-1CR line 4: the North Dakota tax from Form ND-1 line 20, which the ratio is applied to (us.nd.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndJointScheduleTaxAdded value: +{
+ "description": "Marriage Penalty Credit Worksheet line 10: the tax on WORKSHEET LINE 1 — the couple's Form ND-1 line 18 taxable income, NOT their qualified income — computed on the MARRIED FILING JOINTLY rate schedule (us.nd.marriage_penalty_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndLowerQualifiedIncomeAdded value: +{
+ "description": "Marriage Penalty Credit Worksheet: the qualified income of the LOWER-earning spouse, which must exceed $47,550 for 2025 (us.nd.marriage_penalty_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndNetLongTermCapitalGainAdded value: +{
+ "description": "Net long-term capital gain worksheet line 3: the SMALLER of federal Schedule D lines 15 and 16 — or, when no Schedule D was required, the capital gain distributions from Form 1040 line 7. The worksheet stops outright if either Schedule D figure is zero or less, so a net loss yields no exclusion (us.nd.capital_gain_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndOtherStateIncomeBaseAdded value: +{
+ "description": "Schedule ND-1CR line 2: for a full-year resident, federal AGI (Form ND-1 line 1a) LESS the line 5 United States obligation interest — the denominator of the ratio (us.nd.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndOtherStateTaxPaidAdded value: +{
+ "description": "Schedule ND-1CR line 6: the NET income tax shown on the other state's return — after that state's credits but before its withholding and estimated payments — plus any local jurisdiction tax in that same state. Foreign countries do not qualify, and Montana and Minnesota WAGES are excluded by reciprocity (us.nd.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndQualifiedDividendsAdded value: +{
+ "description": "Form ND-1 line 13: qualified dividends from federal Form 1040 or 1040-SR line 3a — North Dakota excludes 40%. A part-year resident or nonresident uses the portion reported to North Dakota (us.nd.qualified_dividend_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndSingleScheduleTaxAAdded value: +{
+ "description": "Marriage Penalty Credit Worksheet line 7: the tax on WORKSHEET LINE 6 computed on the SINGLE rate schedule (us.nd.marriage_penalty_credit). Line 6 is the lower-earning spouse's qualified income MINUS the worksheet's preprinted $15,750 (half the federal joint standard deduction) — the rule takes this line as a computed amount and does NOT subtract the $15,750 itself, so a caller supplying the tax on the unreduced income overstates the credit. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndSingleScheduleTaxBAdded value: +{
+ "description": "Marriage Penalty Credit Worksheet line 9: the tax on WORKSHEET LINE 8 computed on the SINGLE rate schedule (us.nd.marriage_penalty_credit). Line 8 is Form ND-1 line 18 taxable income MINUS that same worksheet line 6 amount (the lower-earning spouse's qualified income less the preprinted $15,750). The rule takes this line as a computed amount and performs neither subtraction itself. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndTaxableIncomeAdded value: +{
+ "description": "Form ND-1 line 18: North Dakota taxable income — the marriage penalty credit requires it to exceed $81,036 for 2025 (us.nd.marriage_penalty_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ndUseRateScheduleAdded value: +{
+ "description": "Form ND-1 line 20: compute from the rate schedule at the exact taxable income instead of the printed Tax Table (taxable income under $100,000 uses the table's $50-row midpoint, which section 57-38-30.3(10) makes mandatory; $100,000 or more always uses the schedule) (us.nd.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riAge65OrDisabledAdded value: +{
+ "description": "Form RI-1040H Part 1 question D: you or your spouse were 65 or older, or receiving Social Security disability benefits, as of December 31, 2025 — plus domicile for the whole year and current taxes/rent (us.ri.property_tax_relief_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "RI Schedule E line 5: total exemptions — yourself (unless claimable by another), your spouse on a joint return, and dependents — $5,100 each (us.ri.exemption)."
+}Input schema / properties / state / properties / riFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form RI-1040 line 1 — the Social Security and pension modification income tests and the use tax lookup table (us.ri.social_security_modification, us.ri.pension_modification, us.ri.use_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riFederalChildCareCreditAdded value: +{
+ "description": "RI Schedule I line 20: the federal child and dependent care credit, Schedule 3 line 2 — 25% (us.ri.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riFederalEicAdded value: +{
+ "description": "RI Schedule EIC line 39: the federal earned income credit, Form 1040 line 27a — 16% (us.ri.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riHouseholdIncomeAdded value: +{
+ "description": "Form RI-1040H line 32: total 2025 household income of every household member, taxable and nontaxable, with losses added back (us.ri.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riHouseholdMembersAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form RI-1040H line 1f: persons in the household — the '1 person' or '2 or more' percentage column (us.ri.property_tax_relief_credit)."
+}Input schema / properties / state / properties / riIncomeTaxAdded value: +{
+ "description": "RI Schedule I line 19: Form RI-1040 line 8 income tax — the cap on the child care credit (us.ri.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riIncomeTaxAfterFederalCreditAdded value: +{
+ "description": "RI Schedule II line 23: line 8 income tax less the Schedule I line 22 credit (us.ri.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riLargePurchasesNetUseTaxAdded value: +{
+ "description": "RI Schedule U line 7e: net use tax due on single purchases of $1,000 or more (7% less sales tax paid) added to the lookup amount (us.ri.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riModifiedAgiAdded value: +{
+ "description": "Modified federal adjusted gross income, Form RI-1040 line 3 (federal AGI plus RI Schedule M net modifications) — the standard deduction and exemption phase-outs (us.ri.standard_deduction, us.ri.exemption) and the other-state credit ratio (us.ri.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riOtherStateIncomeAdded value: +{
+ "description": "RI Schedule II line 24: income derived from the other state (Form RI-1040MU line 29 for several states) (us.ri.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riOtherStateTaxPaidAdded value: +{
+ "description": "RI Schedule II line 28: income tax due and paid to the other state (not withholding; $0 if fully refunded) (us.ri.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riPropertyTaxPaidAdded value: +{
+ "description": "Form RI-1040H line 2: property taxes paid or payable for 2025 on the homestead (the owner's share) (us.ri.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riRentPaidAdded value: +{
+ "description": "Form RI-1040H line 7: rent paid in 2025 for occupancy only (net of utilities and furnishings), also rented land under a taxed home — 20% counts as property tax (us.ri.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riSalesTaxPaidOtherStatesAdded value: +{
+ "description": "RI Schedule U line 3: sales taxes paid in other states on the line 1 purchases (us.ri.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riSocialSecurityBenefitsAdded value: +{
+ "description": "Social Security Worksheet line 8: total Social Security benefits, Form 1040 line 6a (us.ri.social_security_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riSocialSecurityBenefitsFraPersonAdded value: +{
+ "description": "Social Security Worksheet line 9: the part of line 8 attributed to the spouse who has reached full retirement age when only one spouse has (us.ri.social_security_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riSpouseFullRetirementAgeAdded value: +{
+ "description": "The spouse has reached Social Security full retirement age — born on or before March 1, 1959 for 2025 (joint returns) (us.ri.social_security_modification, us.ri.pension_modification).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riSpousePensionIncomeAdded value: +{
+ "description": "Schedule M line 1t table line 2 column (b): the spouse's taxable pension and annuity income on a joint return (us.ri.pension_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riTaxableSocialSecurityAdded value: +{
+ "description": "Social Security Worksheet line 11: taxable Social Security, Form 1040 line 6b (us.ri.social_security_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riTaxpayerFullRetirementAgeAdded value: +{
+ "description": "The taxpayer has reached Social Security full retirement age — born on or before March 1, 1959 for 2025 (Social Security Worksheet line 5; Schedule M line 1t question 1) (us.ri.social_security_modification, us.ri.pension_modification).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riTaxpayerPensionIncomeAdded value: +{
+ "description": "Schedule M line 1t table line 2 column (a): the taxpayer's federally taxable pension and annuity income (Form 1040 line 5b), not IRA distributions or military service pensions (us.ri.pension_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / riUseRateScheduleAdded value: +{
+ "description": "Compute Form RI-1040 line 8 with the Tax Computation Worksheet arithmetic at the exact income instead of the Tax Table (taxable income under $100,000 uses the table's $50-row midpoint by default; $100,000 or more always uses the worksheet) (us.ri.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riUseTaxLookupTableAdded value: +{
+ "description": "RI Schedule U Option #2: use the safe-harbor lookup table on federal AGI instead of actual purchases (us.ri.use_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / riUseTaxPurchasesAdded value: +{
+ "description": "RI Schedule U line 1: total price of purchases subject to use tax — 7% (us.ri.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtAdditionalDeductionBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form IN-111 line 4: the number of standard deduction boxes checked on federal Form 1040 (born before January 2, 1961, or blind) — $1,250 each; the chart allows at most two for single and head of household and four for the 'Married Filing Jointly or Qualifying Widow(er)' row and for married filing separately (us.vt.standard_deduction)."
+}Input schema / properties / state / properties / vtCharitableContributionsAdded value: +{
+ "description": "Form IN-111 line 11: charitable contributions allowable under IRC § 170, whether or not itemized federally — the credit is 5% of the first $20,000 (us.vt.charitable_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtChildrenSixOrUnderAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule IN-112 Part II line 3: number of qualifying children (IRC § 152(c)) who were six years of age or younger at the close of the calendar year — born 2019 through 2025 for tax year 2025 — $1,000 each before the AGI phase-out (us.vt.child_tax_credit)."
+}Input schema / properties / state / properties / vtContributorySystemIncomeAdded value: +{
+ "description": "Retirement Income Exemption Worksheet line 11: income received from the Civil Service Retirement System or another contributory system of the U.S., Vermont or another state based on earnings NOT covered by Social Security — the first $10,000 is excludable on the same AGI thresholds as Social Security, when that election is made (us.vt.retirement_income_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtEitcQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule IN-112 Part II line 5: number of qualifying children from federal Schedule EIC — one or more makes the Vermont credit 38% of the federal credit; none makes it 100% (us.vt.eitc)."
+}Input schema / properties / state / properties / vtEligibleLongTermGainAdded value: +{
+ "description": "Schedule IN-153 Part II line 17: net adjusted capital gain from assets held MORE than three years, excluding gain on a primary or nonprimary residence, depreciable personal property (other than farm property and standing timber), and publicly traded stocks, bonds and financial instruments, less allocated investment interest — 40% is excludable up to $350,000 (us.vt.capital_gains_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form IN-111 line 5d: total personal exemptions — 1 for yourself unless someone can claim you, 1 for a spouse on a joint return only (NOT a qualifying widow(er) or married filing separately), plus other dependents (us.vt.personal_exemption)."
+}Input schema / properties / state / properties / vtFederalAgiAdded value: +{
+ "description": "Form IN-111 line 1: federal adjusted gross income — the base for the 3% minimum tax above $150,000, the retirement and military exclusion phase-outs, the child tax credit and veteran credit phase-outs, the student loan interest limit and the estimated use tax table (us.vt.income_tax and the Vermont credit and exclusion rules). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtFederalChildCareCreditAdded value: +{
+ "description": "Schedule IN-112 Part II line 1: the federal child and dependent care credit from Form 2441 line 11 — Vermont allows 72%, refundable (us.vt.child_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtFederalEicAdded value: +{
+ "description": "Schedule IN-112 Part II line 6: the federal earned income credit from Form 1040 — Vermont allows 38% with qualifying children, 100% without (us.vt.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtFederalTaxAdjustmentBaseAdded value: +{
+ "description": "Schedule IN-119 Part I line 4 (federal tax on qualified plans and tax-favored accounts, investment credit recapture, Form 4972 lump-sum tax) or Part II line 11 (federal credit for the elderly or disabled, Vermont-based investment credit, farm income averaging) — 24% of it is the Vermont adjustment (us.vt.federal_tax_adjustment). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtFederalTaxableIncomeAdded value: +{
+ "description": "Schedule IN-153 line 20 base: federal taxable income (Form 1040 line 15) — the capital gains exclusion cannot exceed 40% of it (us.vt.capital_gains_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtIncomeTaxAdded value: +{
+ "description": "Schedule IN-117 line 18: Vermont income tax from Form IN-111 line 14 (after the charitable credit, before the income adjustment and credits) (us.vt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtMilitaryRetirementIncomeAdded value: +{
+ "description": "Schedule IN-112 line 13: federally taxable U.S. military retirement income and military survivor benefit income (federal Form 1040 line 5b, DFAS 1099-R) — excluded in full at federal AGI up to $125,000, phased out to $175,000, for every filing status (us.vt.military_retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtModifiedAgiAdded value: +{
+ "description": "Schedule IN-117 line 17: modified Vermont adjusted gross income — federal AGI plus Schedule IN-112 lines 3 and 4, less lines 7 and 9 (us.vt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtNetAdjustedCapitalGainAdded value: +{
+ "description": "Schedule IN-153 Part I line 8: net adjusted capital gain — the smaller of federal Schedule D lines 15 and 16, less qualified dividends and other ineligible amounts, less allocated investment interest expense; the base of the $5,000 flat exclusion. Zero when the federal return shows a net capital loss (us.vt.capital_gains_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtOtherStateIncomeAdded value: +{
+ "description": "Schedule IN-117 line 9: modified adjusted gross income taxed by the other state or Canadian province AND by Vermont — the AGI taxed there plus its bonus depreciation and non-Vermont obligation addbacks, less bonus depreciation and U.S. government interest subtracted there (us.vt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtOtherStateTaxPaidAdded value: +{
+ "description": "Schedule IN-117 line 20: income tax PAID to the other state or Canadian province on the line 9 income — not withholding, not city or county tax, and not the portion of Canadian tax taken as a federal foreign tax credit (us.vt.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtRetirementElectionAdded value: +{
+ "description": "Schedule IN-112 line 12 election under 32 V.S.A. § 5830e(e)(1): exclude EITHER federally taxable Social Security ('social_security') OR up to $10,000 of Civil Service Retirement System / other non-Social-Security contributory system income ('contributory_system'); only one may be elected (us.vt.retirement_income_exclusion).",
+ "enum": [
+ "none",
+ "social_security",
+ "contributory_system"
+ ],
+ "type": "string"
+}Input schema / properties / state / properties / vtSelfEmploymentIncomeAdded value: +{
+ "description": "Child Care Contribution Worksheet line 1: net earnings from self-employment, federal Schedule SE line 6 (us.vt.child_care_contribution). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtSelfEmploymentIncomeOutsideVermontAdded value: +{
+ "description": "Child Care Contribution Worksheet line 2: the part of Schedule SE line 6 earned for work performed outside Vermont (us.vt.child_care_contribution). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtStudentLoanInterestDeductedFederallyAdded value: +{
+ "description": "Schedule IN-112 line 16b: student loan interest already deducted on federal Form 1040 Schedule 1 line 21 — only the excess is subtracted for Vermont (us.vt.student_loan_interest_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtStudentLoanInterestPaidAdded value: +{
+ "description": "Schedule IN-112 line 16a: total interest paid in the year on qualified student loans (us.vt.student_loan_interest_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtTaxableSocialSecurityAdded value: +{
+ "description": "Federal Form 1040 line 6b: federally taxable Social Security benefits — excluded in full at federal AGI up to $55,000 ($70,000 joint), phased out to $65,000 ($80,000 joint), when the Social Security election is made (us.vt.retirement_income_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtUsObligationInterestAdded value: +{
+ "description": "Schedule IN-112 Part I line 7: interest income from U.S. government obligations — subtracted from federal AGI before the 3% minimum tax is figured, per the Form IN-111 line 8 instruction (us.vt.income_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtUseRateScheduleAdded value: +{
+ "description": "Form IN-111 line 8: apply the rate schedule at the exact taxable income instead of the printed Tax Table (taxable income under $75,000 uses the $100-row midpoint; 'TAXABLE INCOME UNDER $75,000 USE THE TAX TABLES') (us.vt.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / vtUseTaxEstimateFromTableAdded value: +{
+ "description": "Use Tax Worksheet Part 1: the filer did NOT keep records of untaxed purchases under $1,000 and uses the Estimated Use Tax Table on federal AGI instead of 6% of recorded purchases (us.vt.use_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / vtUseTaxLargePurchasesAdded value: +{
+ "description": "Use Tax Worksheet line 3a: total untaxed purchases of items $1,000 or more each — always reported item by item, even when the table estimates the small purchases (us.vt.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtUseTaxPaidOtherStateAdded value: +{
+ "description": "Use Tax Worksheet line 3d: sales tax paid to another state on the purchases reported on lines 2a and 3a (us.vt.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtUseTaxSmallPurchasesAdded value: +{
+ "description": "Use Tax Worksheet line 2a: total untaxed purchases of items under $1,000 each, from records (us.vt.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / vtVeteranDischargeRecordAdded value: +{
+ "description": "Schedule IN-112 Part II lines 8-12: the filer has a discharge record or other record of separation from active duty verifying service in the uniformed services — the eligibility condition for the $250 veteran credit under 32 V.S.A. § 5830g(b) (us.vt.veteran_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / vtVheipBeneficiariesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule IN-119 Part II line 1: the number of VHEIP account beneficiaries contributed for — each carries its own $2,500 ($5,000 joint) contribution cap (us.vt.vheip_credit)."
+}Input schema / properties / state / properties / vtVheipContributionsAdded value: +{
+ "description": "Schedule IN-119 Part II line 1: contributions during the year to Vermont Higher Education Investment Plan (VHEIP / VT529) accounts — the credit is 10% of the first $2,500 per beneficiary ($5,000 on a joint return) (us.vt.vheip_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return237 fields changedInput schema / properties / deAdditionalDeductionBoxesAdded value: +{
+ "description": "Form PIT-RES line 21: boxes checked for age 65 or over and blindness — $2,500 each, at most two per person: up to four on a joint return, or on a married-filing-SEPARATE return (status 3) when the spouse's boxes qualify under § 1108(b)(2)/(4) (spouse 65+/blind with NO gross income, not another's dependent); two otherwise. On a combined separate return (status 4) this is COLUMN B's own two-box count",
+ "type": "integer"
+}Input schema / properties / deAge60OrOverAdded value: +{
+ "description": "Form PIT-RES line 6: 60 or over on December 31 — the 60-or-over pension tier allows $12,500 of pension PLUS eligible retirement income; under 60 allows only $2,000 of pension",
+ "type": "boolean"
+}Input schema / properties / deAge60PersonsAdded value: +{
+ "description": "Form PIT-RES line 27b: persons 60 or over on December 31 (you and/or your spouse) — an additional $110 each",
+ "type": "integer"
+}Input schema / properties / deCharitableContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form PIT-RES line 43: DE Schedule III contributions to special funds — these INCREASE the balance due or reduce the refund; they are contributions, not credits"
+}Input schema / properties / deCombinedSeparateAdded value: +{
+ "description": "Delaware FILING STATUS 4, 'Married & Filing Combined Separate on this form' — two separate returns combined on one form. Column A is the spouse, column B the taxpayer, and each column takes its own $3,250 standard deduction and its own trip through the brackets. Pass filingStatus 'mfs' alongside this, and supply the deSpouse* column-A inputs",
+ "type": "boolean"
+}Input schema / properties / deDomiciledForPensionExclusionAdded value: +{
+ "description": "TY2026+: the taxpayer has been legally domiciled in Delaware for at least three years — required for the 60-or-over pension exclusion under § 1106(b)(3)f.4 (85 Del. Laws c. 426, effective August 17, 2026); a 60-or-over person without it gets no pension exclusion. Not needed for TY2025",
+ "type": "boolean"
+}Input schema / properties / deEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form PIT-RES line 11 worksheet: earned income (wages, tips, farm or business income) — must be under $2,500, or under $5,000 on a joint return, for the elderly/disabled exclusion"
+}Input schema / properties / deEligibleRetirementIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form PIT-RES line 6, 60-or-over worksheet: dividends, capital gains net of losses, interest, net rental income from real property, and qualified plan distributions (IRA, 401(k), Keogh, IRC 457). Counts ONLY at 60 or over"
+}Input schema / properties / deExemptionsAdded value: +{
+ "description": "Form PIT-RES line 27a: number of federal exemptions (yourself, your spouse on a joint return, and dependents) at $110 each. A childless joint return enters 2. Enter 0 if you are claimed as a dependent on another return",
+ "type": "integer"
+}Input schema / properties / deFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form PIT-RES line 31 worksheet: the federal child and dependent care credit (federal Form 2441 line 11). Delaware allows 50%, capped at $3,000 and at the tax"
+}Input schema / properties / deItemizedDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form PIT-RES line 19: net Delaware itemized deductions from Form PIT-RSA — federal itemized less Delaware income tax and other-state tax taken as a credit, plus foreign taxes paid, the charitable mileage differential and up to $500 of labor organization dues"
+}Input schema / properties / deItemizesAdded value: +{
+ "description": "Form PIT-RES line 20b: itemize Delaware deductions (Form PIT-RSA) instead of the standard deduction. INDEPENDENT of the federal election, but it forfeits the line 21 additional standard deduction entirely. On status 3 or 4 both spouses must make the same election (30 Del. C. 1109(b))",
+ "type": "boolean"
+}Input schema / properties / deMilitaryPensionAdded value: +{
+ "description": "Form PIT-RES line 6 checkbox: the pension is a United States military pension — raises the UNDER-60 exclusion from $2,000 to $12,500. Since 84 Del. Laws c. 437 the definition covers the Army, Navy, Air Force, Marine Corps, Space Force, Coast Guard, the NOAA and Public Health Service commissioned corps, and the National Guard",
+ "type": "boolean"
+}Input schema / properties / deOtherStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Other-state credit worksheet line 1: adjusted gross income from the other state's return. The ratio to Delaware AGI is capped at 100%. More than one state uses DE Schedule I, highest credit first"
+}Input schema / properties / deOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Other-state credit worksheet line 6: income tax paid to the other state net of its credits. EXCLUDES city and county taxes; the District of Columbia counts as a state"
+}Input schema / properties / dePensionIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form PIT-RES line 6: pensions from employers, the United States, this State or its subdivisions. Excludes early distributions (1099-R box 7 code 1, or an early-withdrawal penalty) and employer-paid disability pension income before minimum retirement age"
+}Input schema / properties / deQualifiesElderlyDisabledAdded value: +{
+ "description": "Form PIT-RES line 11 worksheet: at least 60 years old OR totally and permanently disabled on December 31",
+ "type": "boolean"
+}Input schema / properties / deSpouseAdditionalDeductionBoxesAdded value: +{
+ "description": "COLUMN A: boxes checked for the spouse being 65 or over and/or blind — $2,500 each",
+ "type": "integer"
+}Input schema / properties / deSpouseAdditionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's Delaware additions (non-Delaware municipal bond interest, oil depletion, fiduciary adjustment)"
+}Input schema / properties / deSpouseAge60OrOverAdded value: +{
+ "description": "COLUMN A: the spouse was 60 or over on December 31 — the 60-or-over pension tier",
+ "type": "boolean"
+}Input schema / properties / deSpouseAge60PersonsAdded value: +{
+ "description": "COLUMN A: persons 60 or over counted in the spouse column ($110 each)",
+ "type": "integer"
+}Input schema / properties / deSpouseDomiciledForPensionExclusionAdded value: +{
+ "description": "COLUMN A / joint spouse: the spouse has been legally domiciled in Delaware for at least three years (TY2026+ 60-or-over pension exclusion gate)",
+ "type": "boolean"
+}Input schema / properties / deSpouseEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's earned income for the line 11 test"
+}Input schema / properties / deSpouseEligibleRetirementIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's eligible retirement income (60 or over only)"
+}Input schema / properties / deSpouseExemptionsAdded value: +{
+ "description": "COLUMN A: federal exemptions allocated to the spouse. The instructions require status 4 filers to split the total between columns \"in increments of $110\"",
+ "type": "integer"
+}Input schema / properties / deSpouseFederalAgiAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A (filing status 4): the spouse's own federal adjusted gross income, including one half of income from jointly titled securities, bank accounts and real estate (the printed Line 1 Worksheet). REQUIRED when deCombinedSeparate is set"
+}Input schema / properties / deSpouseItemizedDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A (filing status 4): the spouse's own net Delaware itemized deductions. Section 1109(b) requires both spouses to make the SAME itemize-or-standard election, but each column deducts its own amount"
+}Input schema / properties / deSpouseMilitaryPensionAdded value: +{
+ "description": "COLUMN A: the spouse's pension is a United States military pension",
+ "type": "boolean"
+}Input schema / properties / deSpouseOtherStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's income from another state"
+}Input schema / properties / deSpouseOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: income tax the spouse paid to another state"
+}Input schema / properties / deSpousePensionIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's pension income for the line 6 exclusion — spouses each receive their own exclusion"
+}Input schema / properties / deSpouseQualifiesElderlyDisabledAdded value: +{
+ "description": "Form PIT-RES line 11 worksheet: the spouse was at least 60 or totally and permanently disabled — the $4,000 joint tier requires BOTH spouses to qualify",
+ "type": "boolean"
+}Input schema / properties / deSpouseSubtractionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's other Delaware subtractions (line 7 items)"
+}Input schema / properties / deSpouseTaxableSocialSecurityAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's taxable Social Security and Railroad Retirement, subtracted in full"
+}Input schema / properties / deSpouseTuitionAbleContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's DE529 and Delaware ABLE contributions"
+}Input schema / properties / deSpouseUsObligationInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "COLUMN A: the spouse's interest on United States obligations"
+}Input schema / properties / deSpouseVolunteerFirefightersAdded value: +{
+ "description": "COLUMN A: qualifying volunteer firefighters in the spouse column ($1,000 each)",
+ "type": "integer"
+}Input schema / properties / deTuitionAbleContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form PIT-RES line 8b: DE529 contributions (up to $1,000, $2,000 joint, phased out entirely above $100,000 of federal AGI / $200,000 joint, K-12 tuition excluded) plus Delaware ABLE contributions (up to $5,000, $10,000 joint)"
+}Input schema / properties / deUsObligationInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form PIT-RES line 5: interest on United States obligations, including the attributable share of regulated investment company dividends"
+}Input schema / properties / deUseRateScheduleAdded value: +{
+ "description": "Form PIT-RES line 24: compute from the rate schedule at the exact taxable income instead of the printed Tax Table (under $60,000 the table's row midpoint governs by instruction; $60,000 or more always uses the schedule)",
+ "type": "boolean"
+}Input schema / properties / deVolunteerFirefightersAdded value: +{
+ "description": "Form PIT-RES line 29: qualifying active volunteer firefighters or volunteer fire company auxiliary, ambulance or rescue squad members on the return (0-2) at $1,000 each. The Division verifies this credit before processing, so it defaults to none",
+ "type": "integer"
+}Input schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne/id/wv/me — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne/id/wv/me/hi — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / hiCapitalGainsStatutoryThresholdAdded value: +{
+ "description": "HI capital gains worksheet line 12: apply § 235-51(f)(1)(B)'s statutory amount under the 2025 brackets ($48,000 / $72,000 / $96,000) instead of the printed $24,000 / $36,000 / $48,000 — an election to disclose",
+ "type": "boolean"
+}Input schema / properties / hiCasualtyLossesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-5 line 19: casualty and theft losses after $100 per casualty, before the 10%-of-AGI floor (any casualty, not only federal disasters, for 2025)"
+}Input schema / properties / hiCharitableContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-4 lines 15-17: gifts to charity within the 60% / 30% / 20% Hawaii AGI limits"
+}Input schema / properties / hiChildCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Schedule X line 20/22: qualified child and dependent care expenses paid in 2025 (a child under 13 or a disabled dependent/spouse; A+ Program payments qualify)"
+}Input schema / properties / hiChildCareQualifyingPersonsAdded value: +{
+ "description": "HI Schedule X line 17: qualifying persons (1 → $10,000 cap; 2 or more → $20,000); defaults to 1",
+ "type": "integer"
+}Input schema / properties / hiChildRestraintSystemPurchasedAdded value: +{
+ "description": "HI line 31: bought one or more new child passenger restraint systems in 2025 — $25 per return (attach the invoice)",
+ "type": "boolean"
+}Input schema / properties / hiCreditForwardAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 46: overpayment to apply to 2026 estimated tax"
+}Input schema / properties / hiDependentCareBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Schedule X line 18: employer dependent care benefits deducted or excluded (Section B lines 14 + 15) — reduce the expense cap"
+}Input schema / properties / hiDisabledPersonsAdded value: +{
+ "description": "HI line 25 ovals: taxpayers (you and/or your spouse, 0-2) claiming the $7,000 blind/deaf/totally disabled exemption (Form N-172) in lieu of ALL regular exemptions — no dependent or age-65 exemptions with it",
+ "type": "integer"
+}Input schema / properties / hiEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI earned income (wages, tips, net self-employment less the SE tax deduction) — REQUIRED for a dependent filer's standard deduction and for the Schedule X child care credit earned-income limit"
+}Input schema / properties / hiEitcCarryover2022Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Schedule CR line 24 column (c): the 2022 nonrefundable EITC carryover applied this year (Form N-356 Part III; last usable in 2025)"
+}Input schema / properties / hiEstimatedTaxPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 50: Form N-210 estimated tax penalty (added to the payment, or subtracted from the refund)"
+}Input schema / properties / hiExceptionalTreesDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 17: exceptional trees deduction (up to $3,000 per tree, once every three years; notarized arborist affidavit)"
+}Input schema / properties / hiFoodExciseQualifiedExemptionsAdded value: +{
+ "description": "HI Form N-311 line 8 override: qualified exemptions (persons, not the age-65 extra) plus public-agency-supported minor children — defaults to yourself + spouse (when claimed on line 6b) + dependents + hiPublicSupportMinorChildren",
+ "type": "integer"
+}Input schema / properties / hiFundContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI lines 43a-43c: contributions from the overpayment to the Hawaii schools repairs ($2 / $4 joint), public libraries ($5 / $10), and domestic violence / child abuse ($5 / $10) funds — the total"
+}Input schema / properties / hiGamblingLossesInMiscAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Total Itemized Deductions Worksheet line 2d: the gambling and casualty/theft losses inside hiOtherMiscDeductions (protected from the overall limitation)"
+}Input schema / properties / hiHomeMortgageInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-3 lines 10-12: home mortgage interest and points (pre-TCJA $1,000,000 / $100,000 limits; home equity interest allowed)"
+}Input schema / properties / hiIhaPaymentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 16: cash paid into an individual housing account — the composer caps at $5,000 ($10,000 joint)"
+}Input schema / properties / hiInvestmentInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-3 line 13: investment interest (Form N-158) — protected from the overall limitation"
+}Input schema / properties / hiInvestmentInterestN158Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Tax on Capital Gains Worksheet line 9: Form N-158 line 4e (net capital gain elected as investment income)"
+}Input schema / properties / hiItemizeAdded value: +{
+ "description": "HI line 21: itemize deductions (the composer takes the larger of the Worksheets A-1 to A-6 total and the standard deduction; any hi* itemized amount also triggers the comparison)",
+ "type": "boolean"
+}Input schema / properties / hiJobAndMiscExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-6 lines 23-25: unreimbursed employee business expenses, tax preparation fees, investment expenses — subject to the 2%-of-AGI floor"
+}Input schema / properties / hiMedicalExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-1 line 1: medical and dental expenses before the 7.5%-of-Hawaii-AGI floor"
+}Input schema / properties / hiMfsConsideredUnmarriedAdded value: +{
+ "description": "HI Schedule X Part II checkbox: married filing separately but lived apart from the spouse the last six months of 2025, kept the qualifying person's home, and paid over half its cost",
+ "type": "boolean"
+}Input schema / properties / hiNetCapitalGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Tax on Capital Gains Worksheet line 7: Hawaii net capital gain (federal Schedule D line 16 plus Hawaii adjustments) — with hiNetLongTermCapitalGain triggers the 7.25% alternative tax when taxable income exceeds the worksheet threshold"
+}Input schema / properties / hiNetLongTermCapitalGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Tax on Capital Gains Worksheet line 4: Hawaii net long-term capital gain (federal Schedule D line 15 plus Hawaii adjustments)"
+}Input schema / properties / hiOtherFormsTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 27: additional tax from Forms N-2, N-103, N-152, N-168, N-312, N-325, N-338, N-344, N-348, N-405, N-586, N-615, N-814 (Tax Computation Worksheet lines c-m)"
+}Input schema / properties / hiOtherMiscDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-6 line 30: deductions not subject to the 2% floor (gambling losses to the extent of winnings, impairment-related work expenses)"
+}Input schema / properties / hiOtherStateTaxEligibleAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Other State and Foreign Tax Credit Worksheet line 9: income tax paid to other states plus foreign tax not credited federally (exclude tax on Hawaii-exempt income; attach the other returns)"
+}Input schema / properties / hiOtherTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-2 line 8: other deductible taxes"
+}Input schema / properties / hiOutOfStateBondInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 9: interest on bonds of other states and their subdivisions (including mutual fund distributions from them)"
+}Input schema / properties / hiOutOfStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI other-state worksheet line 3: out-of-state income including capital gains (not Hawaii-exempt income such as employer-funded pensions)"
+}Input schema / properties / hiOutOfStateLtcgAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI other-state worksheet line 4: long-term capital gains from sources outside Hawaii"
+}Input schema / properties / hiPensionExclusionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 13: pension distributions taxed federally but not by Hawaii — employer-funded plans (public retirement systems, military pensions, private plans the employee did not contribute to; Schedule J for hybrid plans)"
+}Input schema / properties / hiPersonalPropertyTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-2 line 7: personal property taxes paid to other states"
+}Input schema / properties / hiPresentOverNineMonthsAdded value: +{
+ "description": "HI Form N-311 / Schedule X attestation: every claimed exemption (you, spouse, dependents) was physically present in Hawaii more than nine months in 2025 — REQUIRED for the food/excise and renters credits (unattested → not claimed)",
+ "type": "boolean"
+}Input schema / properties / hiPublicSupportMinorChildrenAdded value: +{
+ "description": "HI Form N-311 line 3: minor children receiving more than half their support from public agencies (DHS, Social Security survivor benefits) who are NOT already counted in the shared `dependents` input (the form lists them on line 3 instead of line 2; a DHS-supported child claimed on line 6c is already in the default count)",
+ "type": "integer"
+}Input schema / properties / hiRealEstateTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-2 line 6: real estate taxes (no foreign real property taxes; no $10,000 cap)"
+}Input schema / properties / hiRentPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Schedule X line 7: rent paid in 2025 for the Hawaii residence NOT exempt from real property tax, net of utilities, parking, ground rent, and subsidies — must exceed $1,000"
+}Input schema / properties / hiRentersExemptionsAdded value: +{
+ "description": "HI Schedule X line 11 override: qualified persons present more than nine months plus 1 for you and 1 for your spouse if 65 or older — defaults to the line 6e count",
+ "type": "integer"
+}Input schema / properties / hiReservePayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 15: your military reserve / Hawaii National Guard duty pay (W-2 Box 16 from the reserve component) — the composer excludes the first $8,636"
+}Input schema / properties / hiSpouseAge65Added value: +{
+ "description": "HI line 6b 'Age 65 or over' oval for the spouse (joint returns, or MFS with the spouse exemption)",
+ "type": "boolean"
+}Input schema / properties / hiSpouseAgiAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Schedule X Part I (married filing separately): the spouse's Hawaii AGI, added for the $30,000 renters test"
+}Input schema / properties / hiSpouseClaimedAsDependentAdded value: +{
+ "description": "HI line 6b: the spouse can be claimed as a dependent on another return — no spouse exemption (joint returns)",
+ "type": "boolean"
+}Input schema / properties / hiSpouseDisabledAdded value: +{
+ "description": "HI line 25: with ONE disabled person on a joint return, the disabled person is the spouse (default: the taxpayer) — decides whose age-65 status gives the non-disabled spouse $2,288 instead of $1,144",
+ "type": "boolean"
+}Input schema / properties / hiSpouseEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Schedule X line 24: the spouse's earned income on a joint return (use the $200 / $400 per-month deemed amount for a student or disabled spouse)"
+}Input schema / properties / hiSpouseExemptionMfsAdded value: +{
+ "description": "HI line 6b on a married filing separate return: the spouse had no income, is not filing a return, and cannot be claimed as a dependent by another — one $1,144 exemption (plus the age-65 extra)",
+ "type": "boolean"
+}Input schema / properties / hiSpouseFederalAgiAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Form N-311 line 5 (married filing separately): the spouse's federal AGI, added for the credit table"
+}Input schema / properties / hiSpouseItemizesAdded value: +{
+ "description": "HI line 21: married filing separately and the spouse itemizes — you MUST itemize (no standard deduction)",
+ "type": "boolean"
+}Input schema / properties / hiSpouseReservePayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 15: the spouse's reserve / National Guard duty pay on a joint return (its own $8,636)"
+}Input schema / properties / hiStateLocalIncomeTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI Worksheet A-2 line 5: state and local income taxes (or the elected general sales taxes) — deductible only when federal AGI is under $100,000 single/MFS, $150,000 HOH, $200,000 MFJ/QSS; exclude taxes claimed under the other-state credit"
+}Input schema / properties / hiTaxpayerAge65Added value: +{
+ "description": "HI line 6a 'Age 65 or over' oval: you were 65 or older as of January 1, 2026 — one extra $1,144 exemption",
+ "type": "boolean"
+}Input schema / properties / hiUseRateScheduleAdded value: +{
+ "description": "HI line 27: compute from the Tax Rate Schedules at the exact income instead of the Tax Table (taxable income under $100,000 uses the table by instruction; $100,000 or more always uses the schedules)",
+ "type": "boolean"
+}Input schema / properties / hiWageDifferenceAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "HI line 8: W-2 Box 16 state wages over Box 1 federal wages (COLA, LQA, ERS contributory/hybrid plan members)"
+}Input schema / properties / ilK12Expenses / descriptionPrevious value: -"IL qualified K-12 education expenses (before the $250 floor)"New value: +"IL Schedule ICR Section B qualified K-12 education expenses before the $250 floor — tuition, book/lab fees at a public, nonpublic OR home school that satisfies the truancy law (105 ILCS 5/26-1; IDOR Pub. 112); the composer takes 25% of the excess over $250, maximum $750"Input schema / properties / ilSpouseTeacherExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "IL Schedule 1299-I column B: the SPOUSE's own educator materials expenses on a joint return — its own $500 cap"
+}Input schema / properties / ilTeacherExpenses / descriptionPrevious value: -"IL Schedule 1299-C educator materials expenses"New value: +"IL Schedule 1299-C / 1299-I Instructional Materials and Supplies Credit: the TAXPAYER's own classroom materials expenses as an eligible K-12 educator (900+ hours) — capped at $500 per educator, not $1,000 per return"Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok",
- "ct",
- "ks",
- "ar",
- "nm",
- "ne",
- "id",
- "wv",
- "me"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct",
+ "ks",
+ "ar",
+ "nm",
+ "ne",
+ "id",
+ "wv",
+ "me",
+ "hi",
+ "ri",
+ "mt",
+ "de",
+ "nd",
+ "vt"
+]Input schema / properties / mt529DepositAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 line 25: amount of the refund deposited into a 529 or 529A account (must exceed $25 per account)"
+}Input schema / properties / mtAbleContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule I line 17: contributions to an ABLE account — capped at $3,000, or $6,000 on a JOINT return. Not inflation-indexed"
+}Input schema / properties / mtActiveDutyMilitaryPayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule I line 12: active-duty military salary, subtracted in full (§ 15-30-2120(3)(c)) — basic, special and incentive pay only. Annual training, inactive duty training and 'active Guard and Reserve duty' pay do NOT qualify"
+}Input schema / properties / mtAge62Added value: +{
+ "description": "Schedule 2EC: the claimant reached age 62 by December 31 — required for the elderly homeowner/renter credit (unattested → not claimed)",
+ "type": "boolean"
+}Input schema / properties / mtAmendedPaymentsWithOriginalAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 line 18 (amended returns): payments made with the original return"
+}Input schema / properties / mtAmendedPreviousOverpaymentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 line 20 (amended returns): previous overpayment"
+}Input schema / properties / mtAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 line 24: amount of the overpayment applied to 2026 estimated taxes"
+}Input schema / properties / mtExemptTribalIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule I line 11: exempt tribal income of an enrolled member living on the reservation of their tribe (Form ETM)"
+}Input schema / properties / mtFederalDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "REQUIRED for Montana. Form 2 line 2: the total of federal Form 1040 lines 12e and 13b — the federal standard OR itemized deduction plus the Schedule 1-A deductions (qualified tips, qualified overtime, passenger vehicle loan interest, the enhanced senior deduction). Montana has NO standard deduction of its own, so this is the only deduction. Do NOT include the federal qualified business income deduction — § 15-30-2120(2)(i) adds it back"
+}Input schema / properties / mtFederalNetLongTermCapitalGainsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule III Part II line 13: federal net long-term capital gains — the denominator of the capital gains block's Montana ratio"
+}Input schema / properties / mtGrossHouseholdIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule 2EC line 18: GROSS household income — ALL income of ALL household members, taxable and non-taxable: the full amount of pensions and annuities, Railroad Retirement and veterans' disability benefits, excluded capital gains, alimony, support money, cash public assistance, tax-exempt interest, ALL Social Security, and refundable credits received in cash (expressly including the 2024 Montana property tax rebate). This is NOT federal AGI. Must be under $45,000"
+}Input schema / properties / mtLoanOutWithholdingAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 line 11e: loan-out withholding from Form LOWCERT"
+}Input schema / properties / mtMilitaryRetireeEligibleAdded value: +{
+ "description": "MCA 15-30-2120(9)(a): the retiree became a Montana resident on or after June 30, 2023, or was a resident both before and after receiving the pension (unattested → no subtraction)",
+ "type": "boolean"
+}Input schema / properties / mtMilitaryRetireeWithinFiveYearsAdded value: +{
+ "description": "MCA 15-30-2120(9)(b): the subtraction is within the five consecutive years allowed after first qualifying (unattested → no subtraction)",
+ "type": "boolean"
+}Input schema / properties / mtMilitaryRetirementIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule I line 13: military pension, military retirement income or military survivor benefits (Form WMRE). The subtraction is the LESSER of Montana source wage income or 50% of this — it is for WORKING military retirees"
+}Input schema / properties / mtMontanaSourceWageIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MCA 15-30-2120(8)(i): Montana source WAGE income, which caps the military retirement subtraction. A fully retired veteran with no wages gets $0"
+}Input schema / properties / mtNetLongTermCapitalGainsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 page 2 line 2: net long-term capital gains subject to the federal tax — generally the LESSER of federal Schedule D line 15 or line 16. Montana taxes these at 3% / 4.1%. Qualified dividends are NOT included: they are Montana ordinary income"
+}Input schema / properties / mtOccupied6MonthsAdded value: +{
+ "description": "Schedule 2EC: the claimant occupied a Montana residence as owner, renter or lessee at least six months during the year",
+ "type": "boolean"
+}Input schema / properties / mtOrdinaryIncomeSourcedToMontanaAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule III Part II line 3: income sourced and taxable to Montana excluding net long-term capital gains (full-year residents: federal Form 1040 line 9 excluding those gains, less related expenses)"
+}Input schema / properties / mtOtherStateCapitalGainsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule III Part II line 11: net long-term capital gain sourced and taxable to the other state or country"
+}Input schema / properties / mtOtherStateOrdinaryIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule III Part II line 1: income sourced and taxable to the other state or country included in Montana taxable income, EXCLUDING net long-term capital gains"
+}Input schema / properties / mtOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule III Part II lines 4 AND 14: the TOTAL income tax liability actually paid to the other state or country, excluding penalties and interest — the same figure feeds both blocks; the line 16 ratio attributes the capital-gains share. North Dakota WAGES are not eligible (reciprocity — file an ND return for a refund); foreign tax is ineligible if a federal Form 1116 credit was claimed"
+}Input schema / properties / mtOtherStateTotalIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule III Part II lines 2 and 12: ALL income sourced and taxable to the other state or country — the denominator of the first ratio"
+}Input schema / properties / mtOutOfStateBondInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule I Part I line 1: interest and mutual fund dividends from state, county or municipal bonds of states OTHER than Montana"
+}Input schema / properties / mtPassThroughEntityTaxCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 line 11c: total pass-through entity tax credit from Montana Schedule(s) K-1, Part V line 1"
+}Input schema / properties / mtPropertyTaxBilledAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule 2EC line 23: property tax billed on the Montana residence and up to one acre, including special assessments and fees but excluding penalties and interest"
+}Input schema / properties / mtRailroadRetirementBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule I lines 22-23: Tier I and Tier II Railroad Retirement benefits included in federal taxable income, exempt by federal law"
+}Input schema / properties / mtRentPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule 2EC line 24: rent paid for the Montana residence — 15% counts as rent-equivalent tax. Excludes mortgage payments, nursing home costs paid directly from Social Security, and rent paid by a rental assistance program"
+}Input schema / properties / mtResided9MonthsAdded value: +{
+ "description": "Schedule 2EC: the claimant resided in Montana at least nine months during the year",
+ "type": "boolean"
+}Input schema / properties / mtScheduleIvOtherTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 line 19: contributions, penalties, interest and other taxes from Schedule IV line 8 — SUBTRACTED from total payments on line 21 rather than added to the tax"
+}Input schema / properties / mtScheduleK1WithholdingAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 2 line 11d: total withholding from Montana Schedule(s) K-1, including mineral royalty withholding"
+}Input schema / properties / mtSoleHouseholdClaimantAdded value: +{
+ "description": "Schedule 2EC: you are the only member of your household claiming the elderly homeowner/renter credit — only one per household (unattested → not claimed)",
+ "type": "boolean"
+}Input schema / properties / mtSpouseAge65Added value: +{
+ "description": "Form 2 line 6: your spouse attained age 65 — a second $5,660 subtraction, on a JOINT return only (a qualifying surviving spouse has no spouse)",
+ "type": "boolean"
+}Input schema / properties / mtStateIncomeTaxAddbackAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule I Part I line 4: state income tax included in federal ITEMIZED deductions, added back — computed on Worksheet B and capped so it never reduces the federal itemized total below the federal standard deduction (§ 15-30-2120(2)(j)). New placement for TY2025"
+}Input schema / properties / mtTaxpayerAge65Added value: +{
+ "description": "Form 2 line 6: you attained age 65 — a $5,660 subtraction for 2025",
+ "type": "boolean"
+}Input schema / properties / mtTuitionSavingsContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule I line 16: contributions to a Montana family education savings (§ 529) account — capped at $4,500, or $9,000 on a JOINT return, for 2025 (House Bill 845 raised it from $3,000)"
+}Input schema / properties / ndAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 30: the amount of the line 29 overpayment to apply to 2026 estimated tax"
+}Input schema / properties / ndCapitalGainAlreadyExcludedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Net long-term capital gain worksheet line 6: the portion of that gain already included on Form ND-1 line 7 or line 16, which is removed BEFORE the 40% is applied"
+}Input schema / properties / ndCollegeSaveContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 12: contributions to a North Dakota College SAVE account (Bank of North Dakota) — capped at $5,000, or $10,000 on a JOINT return. Rollovers from another section 529 plan do NOT qualify"
+}Input schema / properties / ndDoublyTaxedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule ND-1CR line 1c: the part of federal AGI sourced to the other state that was received or earned while a North Dakota resident"
+}Input schema / properties / ndExemptTribalIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 7: exempt income of an enrolled member of a federally recognized tribe who lived on a North Dakota reservation all year (includes the North Dakota portions of Standing Rock and Lake Traverse that lie in South Dakota)"
+}Input schema / properties / ndFederalTaxableIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "REQUIRED for North Dakota. Form ND-1 line 1b: federal TAXABLE income from federal Form 1040 line 15 — North Dakota starts here, not from AGI. May be NEGATIVE: the booklet directs a filer whose federal taxable income calculates below zero to enter the negative number even though Form 1040 line 15 shows 0 — and gives Form ND-EZ line 1b the identical instruction"
+}Input schema / properties / ndInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 34 box AL: interest"
+}Input schema / properties / ndLowerQualifiedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Marriage Penalty Credit Worksheet lines 3-4: the qualified income of the LOWER-earning spouse — wages and tips from federal line 1z, net self-employment income less the self-employment tax deduction, and the taxable IRA, pension, annuity and Social Security amounts, all reduced by the Form ND-1 line 8 and line 15 exclusions. Must exceed $47,550 for 2025"
+}Input schema / properties / ndMilitaryPayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 11: military pay of a member of the armed forces on active or reserve duty or of the national guard, excluded IN FULL with no cap — including federal pay for training, education, mobilization and bonuses, and state pay on state active duty"
+}Input schema / properties / ndMilitaryRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 14: military retirement benefits, excluded IN FULL with no cap, for the retiree or a surviving spouse, and covering a dual-status military technician's federal civil-service retirement"
+}Input schema / properties / ndNetLongTermCapitalGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Net long-term capital gain worksheet line 3: the SMALLER of federal Schedule D lines 15 and 16 — or the capital gain distributions from Form 1040 line 7 when no Schedule D was required. North Dakota excludes 40%. The worksheet stops if either Schedule D figure is zero or less, so a net loss gives no exclusion"
+}Input schema / properties / ndOtherStateIncomeBaseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule ND-1CR line 2: the ratio denominator. Defaults to federal AGI less the line 5 United States obligation interest, which is the printed full-year-resident rule; a part-year resident uses Schedule ND-1NR line 18 instead"
+}Input schema / properties / ndOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule ND-1CR line 6: the NET income tax on the other state's return — after that state's credits but before its withholding and estimated payments — plus local jurisdiction tax in that same state. A separate Schedule ND-1CR is required per state. Montana and Minnesota WAGES are excluded by reciprocity; foreign country tax never qualifies"
+}Input schema / properties / ndPeaceOfficerRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 9: the licensed peace officer retirement benefit exclusion — 20 years of licensed service or medical retirement for disability, employer plan benefits only"
+}Input schema / properties / ndPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 34 box AK: penalty"
+}Input schema / properties / ndPlannedGiftAdjustmentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 2: the planned gift or endowment tax credit adjustment to income, from Schedule ND-1PG line 15 or Schedule ND-1QEC line 16 — an ADDITION, because the contribution that earned the credit also reduced federal taxable income"
+}Input schema / properties / ndQualifiedDividendsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 13: qualified dividends from federal Form 1040 line 3a — North Dakota excludes 40%"
+}Input schema / properties / ndRailroadRetirementBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 8: Railroad Retirement Board benefits — unemployment, sick pay or retirement — to the extent federally taxable. Tier 1 Railroad Retirement belongs HERE, not on line 15"
+}Input schema / properties / ndUnderpaymentInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 37: interest on underpaid estimated tax from Schedule ND-1UT — added into the line 36 balance due"
+}Input schema / properties / ndUsObligationInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 5: interest from United States obligations. The booklet's enumerated list EXCLUDES Freddie Mac, Fannie Mae, Ginnie Mae, federal tax refunds and repurchase agreements"
+}Input schema / properties / ndUseRateScheduleAdded value: +{
+ "description": "Form ND-1 line 20: apply the rate schedule at the exact taxable income instead of the printed Tax Table. Below $100,000 the table is MANDATORY by section 57-38-30.3(10); at $100,000 or more the schedule applies anyway",
+ "type": "boolean"
+}Input schema / properties / ndVoluntaryContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form ND-1 line 31 (when overpaid) or line 35 (when tax is due): total voluntary contributions to the Veterans' Postwar Trust Fund, Watchable Wildlife Fund and Trees for ND Trust Fund"
+}Input schema / properties / riAge65OrDisabledAdded value: +{
+ "description": "Form RI-1040H Part 1 question D: you or your spouse were 65 or older and/or disabled (receiving Social Security disability) as of December 31, 2025 — required for the property tax relief credit (unattested → not claimed)",
+ "type": "boolean"
+}Input schema / properties / riAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI-1040 line 18: amount of the overpayment to apply to 2026 estimated tax (capped at the overpayment remaining after line 15b)"
+}Input schema / properties / riCheckoffContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Checkoff Schedule line 38: voluntary contributions (drug program, Olympic $1/$2 joint, organ transplant, arts council, nongame wildlife, childhood disease, military family relief, behavioral health) — these INCREASE the balance due or reduce the refund"
+}Input schema / properties / riCreditRecaptureAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI-1040 line 10b: recapture of prior year other Rhode Island credits, from RI Schedule CR line 12"
+}Input schema / properties / riFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule I line 20: the federal credit for child and dependent care expenses from federal Form 1040 Schedule 3, line 2 — Rhode Island allows 25% of it, capped at the line 8 tax (nonrefundable)"
+}Input schema / properties / riHouseholdIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form RI-1040H Part 5 line 32: TOTAL household income of ALL persons in the household — taxable AND non-taxable (gross Social Security and pensions, cash public assistance, workers' compensation, unemployment), with rental/business/capital losses added back. This is NOT federal AGI. Must be $40,730 or less for 2025"
+}Input schema / properties / riHouseholdMembersAdded value: +{
+ "description": "Form RI-1040H line 1f: number of persons in the household — selects the '1 person' or '2 or more' column of the computation table (they differ only in the $13,971-$17,460 band). Defaults to 1",
+ "type": "integer"
+}Input schema / properties / riHr1AddbackAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule M line 2k: add-back of federal H.R. 1 (P.L. 119-21) provisions from RI Schedule HR1 - Individual, line 1f (§ 44-30-12(b)(9)) — new for tax year 2025"
+}Input schema / properties / riIndividualMandatePenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI-1040 line 12b: individual mandate (health insurance) shared responsibility penalty — leave $0 and certify full-year coverage where it applies"
+}Input schema / properties / riLargePurchasesNetUseTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule U line 7e: net use tax on each SINGLE purchase of $1,000 or more (cost × 7% less sales tax paid), which must be listed individually and is added on top of the lookup-table amount"
+}Input schema / properties / riLeadPaintCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI-1040 line 14e: residential lead abatement credit from Form RI-6238 line 7 (max $5,000 per unit for removal/abatement, $1,500 for reduction/mitigation, up to three units). Refundable, but rationed against a $250,000 statewide annual fund — the amount received may be prorated"
+}Input schema / properties / riMilitaryServicePensionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule M line 1v: military service pension benefits as defined in 20 C.F.R. § 212.2, from Form 1040 line 5b (§ 44-30-12(c)(11)) — no cap, no age or income test; must not also appear in riTaxpayerPensionIncome"
+}Input schema / properties / riOtherStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule II line 24: income derived from the other state, determined as it would be for federal purposes. More than one state uses Form RI-1040MU (sum the line 29 amounts)"
+}Input schema / properties / riOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule II line 28: income tax actually due and paid to the other state (not the amount withheld — if it was all refunded, enter $0). Attach a copy of the other state's return"
+}Input schema / properties / riOutOfStateBondInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule M line 2a: interest on obligations of any state or its political subdivisions OTHER than Rhode Island (§ 44-30-12(b)(1), (b)(2))"
+}Input schema / properties / riPreviouslyIssuedOverpaymentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI-1040 line 14h: previously issued overpayments (amended returns only)"
+}Input schema / properties / riPropertyTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form RI-1040H line 2: property taxes paid or payable for 2025 on the homestead (homeowners, Part 3)"
+}Input schema / properties / riRailroadRetirementBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule M line 1d: Railroad Retirement benefits taxed federally (1974 Railroad Retirement Act) — subtracted in full, and excluded from the Social Security and pension modifications"
+}Input schema / properties / riRentPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form RI-1040H line 7: rent paid in 2025 (renters, Part 4) — 20% of it counts as property tax. For rented LAND the form adds 20% of the rent to the property tax on line 2"
+}Input schema / properties / riSalesTaxPaidOtherStatesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule U line 3: sales tax paid to other states on those purchases"
+}Input schema / properties / riSocialSecurityBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Social Security Modification Worksheet line 8: TOTAL Social Security benefits, federal Form 1040 line 6a (the denominator of the eligible percentage). Exclude Railroad Retirement"
+}Input schema / properties / riSocialSecurityBenefitsFraPersonAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Social Security Modification Worksheet line 9: the part of line 6a attributable to the person born on or before 03/01/1959 — only needed on a joint return where ONE spouse qualifies; defaults to the full line 6a (percentage 1.0000)"
+}Input schema / properties / riSpouseClaimedAsDependentAdded value: +{
+ "description": "RI Schedule E line 1b: the spouse can be claimed as a dependent on another return — no spouse exemption on a joint return",
+ "type": "boolean"
+}Input schema / properties / riSpouseFullRetirementAgeAdded value: +{
+ "description": "RI Schedule M lines 1s/1t: the spouse was born on or before March 1, 1959 (joint returns only — the (b) Spouse column and the worksheet's 'either you or your spouse' test)",
+ "type": "boolean"
+}Input schema / properties / riSpousePensionIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule M line 1t table, column (b): the SPOUSE's Form 1040 line 5b pension and annuity income (joint returns only), separately capped at $50,000"
+}Input schema / properties / riTaxpayerFullRetirementAgeAdded value: +{
+ "description": "RI Schedule M lines 1s/1t: you reached Social Security full retirement age — the Division's 2025 bright line is BORN ON OR BEFORE MARCH 1, 1959. Required for both the Social Security and the pension/annuity modification (unattested → no modification)",
+ "type": "boolean"
+}Input schema / properties / riTaxpayerPensionIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule M line 1t table, column (a): YOUR federally taxable pension and annuity income from Form 1040 line 5b ONLY. Do NOT include IRAs (line 4b), Railroad Retirement (line 1d), or a military service pension (line 1v). Capped at $50,000 per person for 2025"
+}Input schema / properties / riTuitionSavingsContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule M line 1g: contributions to a Rhode Island CollegeBound (§ 529) account — the composer caps the CONTRIBUTION modification at $500 ($1,000 on a joint return), 'regardless of the number of accounts'. Qualified withdrawals included in federal AGI are a separate, uncapped line 1g item — pass those in `subtractions`"
+}Input schema / properties / riUnderestimatingInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI-1040 line 15b: underestimating interest from Form RI-2210 or RI-2210A — added to the amount due, or subtracted from the overpayment"
+}Input schema / properties / riUseRateScheduleAdded value: +{
+ "description": "RI line 8: compute with the Tax Computation Worksheet arithmetic at the exact taxable income instead of the Tax Table (taxable income under $100,000 uses the table's $50-row midpoint by instruction; $100,000 or more always uses the worksheet)",
+ "type": "boolean"
+}Input schema / properties / riUseTaxLookupTableAdded value: +{
+ "description": "RI Schedule U: use the § 44-30-100 safe-harbor lookup table (0.08% of federal AGI, or the printed $5-$60 band) instead of actual purchases. Either way the taxpayer must PROACTIVELY check the line 12a attestation box — software may not pre-check it",
+ "type": "boolean"
+}Input schema / properties / riUseTaxPurchasesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "RI Schedule U line 1: total price of purchases subject to the 7% use tax (the actual method)"
+}Input schema / properties / stateWithholding / descriptionPrevious value: -"state income tax withheld (IL line 25 / VA 19a / CA 71 / NY 72). CONVENTIONS: IL line 25 sums state withholding from EVERY document (W-2s + all 1099s). NY line 72 = W-2 box 17 NYS withholding PLUS NY-coded state withholding from 1099s whose PAYER has an in-state (NY) address; NY-coded withholding printed by an OUT-OF-STATE-addressed payer is NOT included; disclose any excluded amount in notes. VA 19a = the PRIMARY taxpayer's withholding from EVERY document type (W-2, 1099, VK-1 — Form 760 line 19 instructions name all three; the payer's address does NOT matter for VA, unlike NY); a jointly-issued document's state withholding splits 50/50 between 19a/19b with the odd dollar to the primary."New value: +"state income tax withheld (IL line 25 / VA 19a / CA 71 / NY 72). CONVENTIONS: IL line 25 sums state withholding from EVERY document (W-2s + all 1099s). NY line 72 = total NYS tax withheld from EVERY W-2 box 17, 1099-R box 14, 1099-G box 11, 1099-NEC/MISC state boxes and W-2G — wherever the state box reads NY; the PAYER'S mailing address is irrelevant (an out-of-state payer's NY-coded withholding IS included — IT-201-I line 72). VA 19a = the PRIMARY taxpayer's withholding from EVERY document type (W-2, 1099, VK-1 — Form 760 line 19 instructions name all three; the payer's address does NOT matter for VA, unlike NY); a jointly-issued document's state withholding splits 50/50 between 19a/19b with the odd dollar to the primary."Input schema / properties / vtAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 28a: refund to be credited to 2026 estimated tax"
+}Input schema / properties / vtAppliedToPropertyTaxBillAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 28b: refund to be credited to the 2026 property tax bill"
+}Input schema / properties / vtBonusDepreciationAddbackAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 Part I line 4: federal bonus depreciation allowed under IRC § 168(k) (and, per the 2025 Federal Conformity Supplement, § 168(n) and large-business § 174A) — an ADDITION; use `additions` for anything else the Supplement routes here"
+}Input schema / properties / vtCharitableContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 11: charitable contributions allowable under IRC § 170, whether or not itemized federally — the credit is 5% of the first $20,000"
+}Input schema / properties / vtChildrenSixOrUnderAdded value: +{
+ "description": "Schedule IN-112 Part II line 3: qualifying children six or younger at the close of the calendar year (born 2019-2025 for tax year 2025) — $1,000 each, phased out $20 per $1,000 of federal AGI over $125,000",
+ "type": "integer"
+}Input schema / properties / vtContributorySystemIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Retirement Income Exemption Worksheet line 11: income from the Civil Service Retirement System or another U.S., Vermont or other-state contributory system based on earnings NOT covered by Social Security — the first $10,000 is excludable under the 'contributory_system' election"
+}Input schema / properties / vtEitcQualifyingChildrenAdded value: +{
+ "description": "Schedule IN-112 Part II line 5: number of qualifying children from federal Schedule EIC — one or more makes the Vermont credit 38% of federalEITC; none makes it 100%",
+ "type": "integer"
+}Input schema / properties / vtEligibleLongTermGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-153 Part II line 17: net adjusted capital gain on assets held MORE than three years, excluding a primary or nonprimary residence, depreciable personal property (other than farm property and standing timber) and publicly traded stocks, bonds and financial instruments — 40% is excludable up to $350,000"
+}Input schema / properties / vtExemptBondInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 Part I line 15: interest from Vermont Student Assistance Corporation, Build America, Vermont Telecommunications Authority and Vermont Public Power Supply Authority bonds included in federal AGI"
+}Input schema / properties / vtFarmIncomeAveragingCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-119 line 10: the reduction in federal tax from farm income averaging (Schedule J) — 24% is credited"
+}Input schema / properties / vtFederalAdditionalTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-119 Part I line 4: federal additional tax on qualified plans, IRAs, HSAs and MSAs, recapture of the federal investment credit (Vermont portion) and Form 4972 lump-sum tax — 24% is ADDED to the Vermont tax on line 9"
+}Input schema / properties / vtFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 Part II line 1: the federal child and dependent care credit from Form 2441 line 11 — Vermont pays 72%, refundable"
+}Input schema / properties / vtFederalElderlyDisabledCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-119 Part II line 8: the federal credit for the elderly or the disabled (Schedule R) — 24% is a nonrefundable Vermont credit through line 9"
+}Input schema / properties / vtFederalMedicalExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Medical Deduction Worksheet line 1a: medical and dental expenses from federal Schedule A line 4 — only the excess over the Vermont standard deduction plus exemptions (Form IN-111 line 6) is subtracted on Schedule IN-112 line 11"
+}Input schema / properties / vtFederalTaxableIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-153 line 20: federal taxable income (Form 1040 line 15) — the capital gains exclusion cannot exceed 40% of it; REQUIRED whenever a capital gain is passed"
+}Input schema / properties / vtMilitaryRetirementIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 line 13: federally taxable U.S. military retirement and military survivor benefit income (Form 1040 line 5b, DFAS 1099-R) — excluded in full at federal AGI up to $125,000, phased out to $175,000, any filing status"
+}Input schema / properties / vtNetAdjustedCapitalGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-153 Part I line 8: net adjusted capital gain (the smaller of federal Schedule D lines 15 and 16, less qualified dividends and allocated investment interest) — the base of the $5,000 flat exclusion; $0 when the federal return shows a net capital loss"
+}Input schema / properties / vtNonAllowableMedicalExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Medical Deduction Worksheet line 1b: continuing care retirement community entrance fees and recurring monthly payments included in line 1a, which Vermont disallows"
+}Input schema / properties / vtNonVermontBondInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 Part I line 3: interest and dividends from NON-Vermont state and local obligations exempt from federal tax (line 1 less the Vermont-obligation portion on line 2) — an ADDITION"
+}Input schema / properties / vtNonresidentEstimatedPaymentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 26e: nonresident estimated tax payments (nonresident withholding) allocated on Schedule K-1VT line 30"
+}Input schema / properties / vtOtherStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-117 line 9: modified AGI taxed by the other state or Canadian province AND by Vermont (the AGI taxed there, adjusted for its bonus depreciation, non-Vermont obligation and U.S. interest items); one schedule per state, pass the sum"
+}Input schema / properties / vtOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-117 line 20: income tax PAID to the other state or Canadian province — not withholding, not city or county tax, not the part of Canadian tax taken as a federal foreign tax credit"
+}Input schema / properties / vtPriorYearBonusDepreciationAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 Part I line 9: the subtraction for prior years' bonus depreciation (standard MACRS less the federal amount; Technical Bulletin TB-44)"
+}Input schema / properties / vtRailroadRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 Part I line 14: Railroad Retirement Tier 1 and Tier 2 benefits included in federal AGI — exempt in full"
+}Input schema / properties / vtRealEstateWithholdingAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 26d: 2025 Vermont real estate withholding from Form RW-171"
+}Input schema / properties / vtRetirementElectionAdded value: +{
+ "description": "Schedule IN-112 line 12: the § 5830e(e)(1) election — exclude EITHER federally taxable Social Security ('social_security', using taxableSocialSecurity) OR up to $10,000 of Civil Service / other non-Social-Security contributory system income ('contributory_system', using vtContributorySystemIncome). Only one may be elected; the military exclusion is separate and additional",
+ "enum": [
+ "none",
+ "social_security",
+ "contributory_system"
+ ],
+ "type": "string"
+}Input schema / properties / vtSelfEmploymentIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 21 worksheet line 1: net earnings from self-employment, federal Schedule SE line 6 — the child care contribution is 0.11% of the Vermont-source portion"
+}Input schema / properties / vtSelfEmploymentIncomeOutsideVermontAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 21 worksheet line 2: the part of Schedule SE line 6 earned for work performed outside Vermont"
+}Input schema / properties / vtSolarCreditCarryforwardAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-119 line 13: Vermont-based solar energy credit carryforward (at 24%)"
+}Input schema / properties / vtSpouseClaimedAsDependentAdded value: +{
+ "description": "Form IN-111 line 5b: another person can claim the spouse as a dependent, so the joint return takes no spouse exemption",
+ "type": "boolean"
+}Input schema / properties / vtStudentLoanInterestDeductedFederallyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 line 16b: student loan interest already deducted on federal Schedule 1 line 21"
+}Input schema / properties / vtStudentLoanInterestPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 line 16a: total interest paid in the year on qualified student loans — the excess over the federal deduction is subtracted, unless federal AGI exceeds $200,000 (joint) or $120,000 (all others)"
+}Input schema / properties / vtTaxableStateRefundsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 Part I line 10: taxable refunds of state and local income taxes reported on federal Form 1040 — subtracted"
+}Input schema / properties / vtUnderpaymentInterestPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 31: interest and penalty on underpayment of estimated tax from Worksheet IN-152 or IN-152A"
+}Input schema / properties / vtUsObligationInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-112 Part I line 7: interest income from U.S. government obligations — also subtracted from federal AGI before the 3% minimum tax on line 8"
+}Input schema / properties / vtUseRateScheduleAdded value: +{
+ "description": "Form IN-111 line 8: apply the rate schedule at the exact taxable income instead of the printed Tax Table (mandatory below $75,000: 'TAXABLE INCOME UNDER $75,000 USE THE TAX TABLES')",
+ "type": "boolean"
+}Input schema / properties / vtUseTaxEstimateFromTableAdded value: +{
+ "description": "Use Tax Worksheet Part 1: no records of untaxed purchases under $1,000 were kept — estimate them from the AGI table ($0 to $45 by $10,000 band; 0.05% of AGI, at most $150, above $100,000)",
+ "type": "boolean"
+}Input schema / properties / vtUseTaxLargePurchasesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Use Tax Worksheet line 3a: total untaxed purchases of items of $1,000 or more each (6%, always itemized)"
+}Input schema / properties / vtUseTaxPaidOtherStateAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Use Tax Worksheet line 3d: sales tax paid to another state on those purchases"
+}Input schema / properties / vtUseTaxSmallPurchasesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Use Tax Worksheet line 2a: total recorded untaxed purchases of items under $1,000 each (6%)"
+}Input schema / properties / vtVermontCreditRecaptureAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-119 Part I line 6: recapture of Vermont credits — added on line 9"
+}Input schema / properties / vtVermontInvestmentCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-119 line 9: the federal investment tax credit attributable to Vermont property — 24% is credited"
+}Input schema / properties / vtVeteranDischargeRecordAdded value: +{
+ "description": "Schedule IN-112 Part II lines 8-12: the filer has a discharge record or other record of separation from active duty verifying service in the uniformed services — the $250 refundable veteran credit, phased out between $25,000 and $30,000 of federal AGI (new for 2025)",
+ "type": "boolean"
+}Input schema / properties / vtVheipBeneficiariesAdded value: +{
+ "description": "Schedule IN-119 Part II line 1: the number of VHEIP beneficiaries contributed for",
+ "type": "integer"
+}Input schema / properties / vtVheipContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule IN-119 Part II line 1: contributions to Vermont Higher Education Investment Plan (VT529) accounts — the credit is 10% of the first $2,500 per beneficiary ($5,000 joint)"
+}Input schema / properties / vtVoluntaryContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form IN-111 line 24e: total voluntary contributions to the Vermont Veterans Fund, Green Up Vermont, Nongame Wildlife Fund and Vermont Children's Trust Foundation (lines 24a-24d) — added to the balance due or taken from the refund"
+}calculate_tax39 fields changedInput schema / properties / state / properties / meAdultCareExpensesAdded value: +{
+ "description": "Adult Dependent Care Credit Worksheet line 1 column C: adult day care, hospice, and respite expenses not used for the federal credit (us.me.adult_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meAdultCareQualifyingIndividualsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Adult Dependent Care Credit Worksheet: qualifying individuals (1 → $3,000 cap; 2 or more → $6,000) (us.me.adult_dependent_care_credit)."
+}Input schema / properties / state / properties / meAge65Added value: +{
+ "description": "Schedule PTFC/STFC line 7: you or your spouse (MFJ) were at least 65 during the tax year — $4,100 benefit base and $2,000 cap (us.me.property_tax_fairness_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meAgeBlindBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040ME lines 12a-12d boxes checked (you 65+, you blind, spouse 65+, spouse blind) — $2,000 each for single/HOH, $1,600 each for MFJ/QSS/MFS (us.me.standard_deduction)."
+}Input schema / properties / state / properties / meAgiAdded value: +{
+ "description": "Maine adjusted gross income, Form 1040ME line 16 — the deduction and exemption phase-outs, dependent credit phase-out, other-jurisdiction ratio, and use tax estimate (us.me.deduction_phaseout, us.me.personal_exemption, us.me.dependent_exemption_credit, us.me.other_jurisdiction_credit, us.me.use_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meChildCareExpensesAdded value: +{
+ "description": "Child Care Credit Worksheet line 1: total expenses on federal Form 2441 line 2 column (d) (us.me.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meDeductionBeforePhaseoutAdded value: +{
+ "description": "Form 1040ME line 17 worksheet line 6: the standard deduction from the chart or Schedule 2 line 7 itemized deductions, before the phase-out (us.me.deduction_phaseout). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meDependents13aAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040ME line 13a: qualifying children and dependents for the federal child tax credit or credit for other dependents (us.me.property_tax_fairness_credit, us.me.sales_tax_fairness_credit)."
+}Input schema / properties / state / properties / meDependentsSixPlusAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependent Exemption Tax Credit Worksheet line 1: qualifying children and dependents (line 13a) at least 6 years old at any time in the year — $305 each (us.me.dependent_exemption_credit)."
+}Input schema / properties / state / properties / meDependentsUnderSixAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependent Exemption Tax Credit Worksheet line 3: qualifying children and dependents under 6 at the end of the year — $610 each (us.me.dependent_exemption_credit)."
+}Input schema / properties / state / properties / meDisabledVeteranAdded value: +{
+ "description": "Schedule PTFC/STFC line 14: you or your spouse are rated 100% permanently and totally disabled by the VA — the credit doubles (us.me.property_tax_fairness_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meExemptIncomeCostsAdded value: +{
+ "description": "Schedule 2 line 2b: deductible costs of producing Maine-exempt income included in the federal itemized total (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040ME line 13: personal exemptions (0, 1, or 2) — $5,150 each (us.me.personal_exemption)."
+}Input schema / properties / state / properties / meFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form 1040ME line 14 — the pension deduction phase-out and the adult dependent care percentage (us.me.pension_deduction, us.me.adult_dependent_care_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meFederalChildCareCreditAdded value: +{
+ "description": "Child Care Credit Worksheet line 2: the federal child and dependent care credit, Schedule 3 line 2 (us.me.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meFederalEicAdded value: +{
+ "description": "Earned Income Tax Credit Worksheet line 1: federal EIC, Form 1040 line 27a (or the pro forma amount) (us.me.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meFederalItemizedDeductionsAdded value: +{
+ "description": "Schedule 2 line 1: federal Schedule A line 17 (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meFinancialInstitutionCostsAdded value: +{
+ "description": "Schedule 2 line 2c: itemized amounts attributable to a pass-through financial institution ownership interest (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meHasQualifyingChildAdded value: +{
+ "description": "Earned Income Tax Credit Worksheet: at least one qualifying child for the federal EIC — 25% instead of 50% (us.me.eitc).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meMaineTaxableIncomeCostsAdded value: +{
+ "description": "Schedule 2 line 3a: deductible costs of producing income exempt federally but taxable by Maine (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meMedicalDeductionAdded value: +{
+ "description": "Schedule 2 line 2d: medical and dental expenses deducted, federal Schedule A line 4 — removed from the capped total and added back uncapped (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meMilitaryRetirementAdded value: +{
+ "description": "Pension Income Deduction Worksheet line P9: eligible military retirement pay in federal AGI — 100% deductible (us.me.pension_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meNonMilitaryPensionAdded value: +{
+ "description": "Pension Income Deduction Worksheet line P1 for one recipient: eligible non-military employee retirement plan and IRA benefits in federal AGI (us.me.pension_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meOtherJurisdictionIncomeAdded value: +{
+ "description": "Other Jurisdiction worksheet line 2d: income sourced to and taxed by the other jurisdiction, adjusted for Maine modifications (us.me.other_jurisdiction_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meOtherJurisdictionTaxAdded value: +{
+ "description": "Other Jurisdiction worksheet line 4b: income tax paid to the other jurisdiction on that income (not withholding) (us.me.other_jurisdiction_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mePersonalPropertyTaxes5cAdded value: +{
+ "description": "Schedule 2 line 3c: personal property taxes, federal Schedule A line 5c (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mePropertyTaxPaidAdded value: +{
+ "description": "Schedule PTFC/STFC line 4: property tax paid on the Maine home in 2025 (up to 10 acres) (us.me.property_tax_fairness_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meRealEstateTaxes5bAdded value: +{
+ "description": "Schedule 2 line 3b: state and local real estate taxes, federal Schedule A line 5b (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meRentIncludesUtilitiesAdded value: +{
+ "description": "Schedule PTFC/STFC line 5b: the rent includes heat, utilities, furniture, or similar items (us.me.property_tax_fairness_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meRentPaidAdded value: +{
+ "description": "Schedule PTFC/STFC line 5a: rent paid on the Maine home in 2025 (us.me.property_tax_fairness_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meSaltTaxes5eAdded value: +{
+ "description": "Schedule 2 line 2a: taxes paid, federal Schedule A line 5e (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meSocialSecurityReceivedAdded value: +{
+ "description": "Pension Income Deduction Worksheet line P3: the recipient's total Social Security and railroad retirement benefits received, whether taxable or not (us.me.pension_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meStar5ChildCareExpensesAdded value: +{
+ "description": "Child Care Credit Worksheet line 1a column B: expenses paid to a Star 5 quality certificate provider — that share of the credit is 50% instead of 25% (us.me.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meTaxBeforeCreditsAdded value: +{
+ "description": "Form 1040ME line 20 income tax (us.me.other_jurisdiction_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meTotalIncomeAdded value: +{
+ "description": "Schedule PTFC/STFC line 3: total income — federal total income plus nontaxable Social Security/railroad benefits, tax-exempt interest, and loss add-backs (us.me.property_tax_fairness_credit, us.me.sales_tax_fairness_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meUseRateScheduleAdded value: +{
+ "description": "Compute Form 1040ME line 20 from the rate schedule at the exact income instead of the tax table (taxable income under $100,000 uses the table's $100-row midpoint by default) (us.me.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meUseTaxEstimateAdded value: +{
+ "description": "Form 1040ME line 30: use the 0.04% of Maine AGI estimate for unknown untaxed purchases (us.me.use_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meUseTaxPurchasesAdded value: +{
+ "description": "Form 1040ME line 30: purchases for use in Maine on which no sales tax was paid — 5.5% (us.me.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meUtilitiesAmountAdded value: +{
+ "description": "Schedule PTFC/STFC line 5c: the known amount of heat, utilities, furniture, or similar items in the rent; $0 with meRentIncludesUtilities means unknown → 15% of the rent (us.me.property_tax_fairness_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return39 fields changedInput schema / properties / state / properties / meAdultCareExpensesAdded value: +{
+ "description": "Adult Dependent Care Credit Worksheet line 1 column C: adult day care, hospice, and respite expenses not used for the federal credit (us.me.adult_dependent_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meAdultCareQualifyingIndividualsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Adult Dependent Care Credit Worksheet: qualifying individuals (1 → $3,000 cap; 2 or more → $6,000) (us.me.adult_dependent_care_credit)."
+}Input schema / properties / state / properties / meAge65Added value: +{
+ "description": "Schedule PTFC/STFC line 7: you or your spouse (MFJ) were at least 65 during the tax year — $4,100 benefit base and $2,000 cap (us.me.property_tax_fairness_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meAgeBlindBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040ME lines 12a-12d boxes checked (you 65+, you blind, spouse 65+, spouse blind) — $2,000 each for single/HOH, $1,600 each for MFJ/QSS/MFS (us.me.standard_deduction)."
+}Input schema / properties / state / properties / meAgiAdded value: +{
+ "description": "Maine adjusted gross income, Form 1040ME line 16 — the deduction and exemption phase-outs, dependent credit phase-out, other-jurisdiction ratio, and use tax estimate (us.me.deduction_phaseout, us.me.personal_exemption, us.me.dependent_exemption_credit, us.me.other_jurisdiction_credit, us.me.use_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meChildCareExpensesAdded value: +{
+ "description": "Child Care Credit Worksheet line 1: total expenses on federal Form 2441 line 2 column (d) (us.me.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meDeductionBeforePhaseoutAdded value: +{
+ "description": "Form 1040ME line 17 worksheet line 6: the standard deduction from the chart or Schedule 2 line 7 itemized deductions, before the phase-out (us.me.deduction_phaseout). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meDependents13aAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040ME line 13a: qualifying children and dependents for the federal child tax credit or credit for other dependents (us.me.property_tax_fairness_credit, us.me.sales_tax_fairness_credit)."
+}Input schema / properties / state / properties / meDependentsSixPlusAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependent Exemption Tax Credit Worksheet line 1: qualifying children and dependents (line 13a) at least 6 years old at any time in the year — $305 each (us.me.dependent_exemption_credit)."
+}Input schema / properties / state / properties / meDependentsUnderSixAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependent Exemption Tax Credit Worksheet line 3: qualifying children and dependents under 6 at the end of the year — $610 each (us.me.dependent_exemption_credit)."
+}Input schema / properties / state / properties / meDisabledVeteranAdded value: +{
+ "description": "Schedule PTFC/STFC line 14: you or your spouse are rated 100% permanently and totally disabled by the VA — the credit doubles (us.me.property_tax_fairness_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meExemptIncomeCostsAdded value: +{
+ "description": "Schedule 2 line 2b: deductible costs of producing Maine-exempt income included in the federal itemized total (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040ME line 13: personal exemptions (0, 1, or 2) — $5,150 each (us.me.personal_exemption)."
+}Input schema / properties / state / properties / meFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form 1040ME line 14 — the pension deduction phase-out and the adult dependent care percentage (us.me.pension_deduction, us.me.adult_dependent_care_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meFederalChildCareCreditAdded value: +{
+ "description": "Child Care Credit Worksheet line 2: the federal child and dependent care credit, Schedule 3 line 2 (us.me.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meFederalEicAdded value: +{
+ "description": "Earned Income Tax Credit Worksheet line 1: federal EIC, Form 1040 line 27a (or the pro forma amount) (us.me.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meFederalItemizedDeductionsAdded value: +{
+ "description": "Schedule 2 line 1: federal Schedule A line 17 (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meFinancialInstitutionCostsAdded value: +{
+ "description": "Schedule 2 line 2c: itemized amounts attributable to a pass-through financial institution ownership interest (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meHasQualifyingChildAdded value: +{
+ "description": "Earned Income Tax Credit Worksheet: at least one qualifying child for the federal EIC — 25% instead of 50% (us.me.eitc).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meMaineTaxableIncomeCostsAdded value: +{
+ "description": "Schedule 2 line 3a: deductible costs of producing income exempt federally but taxable by Maine (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meMedicalDeductionAdded value: +{
+ "description": "Schedule 2 line 2d: medical and dental expenses deducted, federal Schedule A line 4 — removed from the capped total and added back uncapped (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meMilitaryRetirementAdded value: +{
+ "description": "Pension Income Deduction Worksheet line P9: eligible military retirement pay in federal AGI — 100% deductible (us.me.pension_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meNonMilitaryPensionAdded value: +{
+ "description": "Pension Income Deduction Worksheet line P1 for one recipient: eligible non-military employee retirement plan and IRA benefits in federal AGI (us.me.pension_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meOtherJurisdictionIncomeAdded value: +{
+ "description": "Other Jurisdiction worksheet line 2d: income sourced to and taxed by the other jurisdiction, adjusted for Maine modifications (us.me.other_jurisdiction_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meOtherJurisdictionTaxAdded value: +{
+ "description": "Other Jurisdiction worksheet line 4b: income tax paid to the other jurisdiction on that income (not withholding) (us.me.other_jurisdiction_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mePersonalPropertyTaxes5cAdded value: +{
+ "description": "Schedule 2 line 3c: personal property taxes, federal Schedule A line 5c (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mePropertyTaxPaidAdded value: +{
+ "description": "Schedule PTFC/STFC line 4: property tax paid on the Maine home in 2025 (up to 10 acres) (us.me.property_tax_fairness_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meRealEstateTaxes5bAdded value: +{
+ "description": "Schedule 2 line 3b: state and local real estate taxes, federal Schedule A line 5b (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meRentIncludesUtilitiesAdded value: +{
+ "description": "Schedule PTFC/STFC line 5b: the rent includes heat, utilities, furniture, or similar items (us.me.property_tax_fairness_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meRentPaidAdded value: +{
+ "description": "Schedule PTFC/STFC line 5a: rent paid on the Maine home in 2025 (us.me.property_tax_fairness_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meSaltTaxes5eAdded value: +{
+ "description": "Schedule 2 line 2a: taxes paid, federal Schedule A line 5e (us.me.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meSocialSecurityReceivedAdded value: +{
+ "description": "Pension Income Deduction Worksheet line P3: the recipient's total Social Security and railroad retirement benefits received, whether taxable or not (us.me.pension_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meStar5ChildCareExpensesAdded value: +{
+ "description": "Child Care Credit Worksheet line 1a column B: expenses paid to a Star 5 quality certificate provider — that share of the credit is 50% instead of 25% (us.me.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meTaxBeforeCreditsAdded value: +{
+ "description": "Form 1040ME line 20 income tax (us.me.other_jurisdiction_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meTotalIncomeAdded value: +{
+ "description": "Schedule PTFC/STFC line 3: total income — federal total income plus nontaxable Social Security/railroad benefits, tax-exempt interest, and loss add-backs (us.me.property_tax_fairness_credit, us.me.sales_tax_fairness_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meUseRateScheduleAdded value: +{
+ "description": "Compute Form 1040ME line 20 from the rate schedule at the exact income instead of the tax table (taxable income under $100,000 uses the table's $100-row midpoint by default) (us.me.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meUseTaxEstimateAdded value: +{
+ "description": "Form 1040ME line 30: use the 0.04% of Maine AGI estimate for unknown untaxed purchases (us.me.use_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / meUseTaxPurchasesAdded value: +{
+ "description": "Form 1040ME line 30: purchases for use in Maine on which no sales tax was paid — 5.5% (us.me.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / meUtilitiesAmountAdded value: +{
+ "description": "Schedule PTFC/STFC line 5c: the known amount of heat, utilities, furniture, or similar items in the rent; $0 with meRentIncludesUtilities means unknown → 15% of the rent (us.me.property_tax_fairness_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return50 fields changedInput schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne/id/wv — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne/id/wv/me — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok",
- "ct",
- "ks",
- "ar",
- "nm",
- "ne",
- "id",
- "wv"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct",
+ "ks",
+ "ar",
+ "nm",
+ "ne",
+ "id",
+ "wv",
+ "me"
+]Input schema / properties / me529BeneficiariesAdded value: +{
+ "description": "ME Schedule 1S line 8: number of 529 beneficiaries (defaults to 1)",
+ "type": "integer"
+}Input schema / properties / me529ContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 1S line 8: contributions to 529 plans — the composer caps at $1,000 per beneficiary (me529Beneficiaries) and allows it only when federal AGI is not over $100,000 single/MFS or $200,000 otherwise"
+}Input schema / properties / meAdultCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME adult dependent care credit: adult day care, hospice, and respite expenses for a disabled adult dependent (not used for the federal credit) — 25% × the federal percentage, up to $500 refundable"
+}Input schema / properties / meAdultCareQualifyingIndividualsAdded value: +{
+ "description": "ME adult dependent care: qualifying individuals (1 → $3,000 cap; 2+ → $6,000); defaults to 1",
+ "type": "integer"
+}Input schema / properties / meAge65Added value: +{
+ "description": "ME Schedule PTFC/STFC line 7: you or your spouse (MFJ) were at least 65 during the tax year — $4,100 benefit base and $2,000 cap",
+ "type": "boolean"
+}Input schema / properties / meAmendedOverpaymentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME line 26 (amended only): overpayment on the original return"
+}Input schema / properties / meCasualRentalSalesTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME line 30a: sales tax collected on casual rentals of living quarters (9%; $2,000 or less)"
+}Input schema / properties / meChildCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME child care worksheet line 1: total expenses on Form 2441 line 2(d)"
+}Input schema / properties / meContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME line 31: Schedule CP charitable contributions and park passes"
+}Input schema / properties / meCreditForwardAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME line 34a: overpayment to credit to 2026 estimated tax"
+}Input schema / properties / meCreditRecaptureAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME line 20a: tax credit recapture amounts"
+}Input schema / properties / meDependentsUnderSixAdded value: +{
+ "description": "ME dependent exemption credit: how many of the line 13a dependents were under 6 at the end of 2025 ($610 each instead of $305)",
+ "type": "integer"
+}Input schema / properties / meDisabledVeteranAdded value: +{
+ "description": "ME Schedule PTFC/STFC line 14: you or your spouse are rated 100% permanently and totally disabled by the VA — the credit doubles",
+ "type": "boolean"
+}Input schema / properties / meExemptIncomeCostsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 2 line 2b: costs of producing Maine-exempt income"
+}Input schema / properties / meFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME child care credit: the federal child and dependent care credit (Schedule 3 line 2) — 25% (50% for Star 5 provider expenses), up to $500 refundable"
+}Input schema / properties / meFederalItemizedAdded value: +{
+ "description": "ME line 17: the filer itemized on the federal return — Schedule 2 is computed and the LARGER of it and the standard deduction is used (pass meFederalItemizedDeductions and the Schedule 2 amounts)",
+ "type": "boolean"
+}Input schema / properties / meFederalItemizedDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 2 line 1: federal Schedule A line 17"
+}Input schema / properties / meFinancialInstitutionCostsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 2 line 2c: itemized amounts attributable to a pass-through financial institution ownership interest (removed)"
+}Input schema / properties / meHasQualifyingChildAdded value: +{
+ "description": "ME EITC: the filer had at least one qualifying child for the federal EIC (25% of the federal credit; 50% without)",
+ "type": "boolean"
+}Input schema / properties / meMaineTaxableIncomeCostsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 2 line 3a: costs of producing federally-exempt, Maine-taxable income"
+}Input schema / properties / meMedicalDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 2 line 2d: medical and dental expenses deducted (Schedule A line 4) — removed from the $36,300-capped total and added back uncapped"
+}Input schema / properties / meMilitaryPayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 1S line 5: non-Maine active duty military pay of a Maine resident"
+}Input schema / properties / meMilitaryRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME pension worksheet P9: eligible military retirement pay in federal AGI (100% deductible; taxpayer and spouse combined)"
+}Input schema / properties / meNonMaineBondInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 1A line 1: income from municipal and state bonds other than Maine (added)"
+}Input schema / properties / meNonMilitaryPensionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 1S line 4 worksheet P1 (taxpayer): eligible non-military employee retirement plan and IRA benefits in federal AGI (not distributions before 55 outside a periodic series, not Roth conversions)"
+}Input schema / properties / meOtherJurisdictionIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME other-jurisdiction credit worksheet line 2d: income sourced to and taxed by the other jurisdiction, adjusted for Maine modifications"
+}Input schema / properties / meOtherJurisdictionTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME other-jurisdiction credit worksheet line 4b: income tax paid to the other jurisdiction on that income (not withholding) — enclose that return"
+}Input schema / properties / mePersonalPropertyTaxes5cAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 2 line 3c: personal property taxes (Schedule A line 5c) — added back"
+}Input schema / properties / mePropertyTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule PTFC/STFC line 4: property tax paid in 2025 on the Maine principal residence (house and up to 10 acres)"
+}Input schema / properties / meRealEstateTaxes5bAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 2 line 3b: real estate taxes (Schedule A line 5b) — added back"
+}Input schema / properties / meRentIncludesUtilitiesAdded value: +{
+ "description": "ME Schedule PTFC/STFC line 5b: the rent includes heat, utilities, furniture, or similar items",
+ "type": "boolean"
+}Input schema / properties / meRentPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule PTFC/STFC line 5a: rent paid in 2025 on the Maine principal residence"
+}Input schema / properties / meSaltTaxes5eAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 2 line 2a: taxes paid included in the federal total (Schedule A line 5e) — removed"
+}Input schema / properties / meSocialSecurityReceivedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME pension worksheet P3 (taxpayer): total Social Security and railroad retirement benefits RECEIVED, taxable or not — reduces the $48,216 cap"
+}Input schema / properties / meSpouseClaimedAsDependentAdded value: +{
+ "description": "ME line 13: the spouse can be claimed as a dependent on another return (MFJ → 1 exemption instead of 2)",
+ "type": "boolean"
+}Input schema / properties / meSpouseNoIncomeMfsAdded value: +{
+ "description": "ME line 13 (married filing separately): your spouse had no federal gross income and you would claim a federal personal exemption for them — 2 exemptions",
+ "type": "boolean"
+}Input schema / properties / meSpouseNonMilitaryPensionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME pension worksheet P1 (spouse column, MFJ only — the spouse's own earned pension)"
+}Input schema / properties / meSpouseSocialSecurityReceivedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME pension worksheet P3 (spouse column)"
+}Input schema / properties / meStar5ChildCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME child care worksheet line 1a column B: expenses paid to a Star 5 quality certificate provider"
+}Input schema / properties / meStateRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 1S line 2: state income tax refund in federal AGI"
+}Input schema / properties / meStudentLoanCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule A line 5: Student Loan Repayment Tax Credit from its worksheet (≤ $2,500, refundable)"
+}Input schema / properties / meTotalIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule PTFC/STFC line 3: total income = federal total income (Form 1040 line 9) + Social Security/railroad benefits not in it + tax-exempt interest + loss add-backs — REQUIRED for the Property Tax Fairness Credit and used for the Sales Tax Fairness Credit (defaults to federal AGI when omitted, with a note)"
+}Input schema / properties / meUnderpaymentPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME line 32: Form 2210ME underpayment of estimated tax penalty"
+}Input schema / properties / meUsInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule 1S line 1: U.S. Government bond interest in federal AGI"
+}Input schema / properties / meUseRateScheduleAdded value: +{
+ "description": "ME line 20: compute from the rate schedule at the exact income instead of the tax table (the table's $100-row midpoint applies under $100,000 by default)",
+ "type": "boolean"
+}Input schema / properties / meUseTaxEstimateAdded value: +{
+ "description": "ME line 30: also add the 0.04%-of-Maine-AGI estimate for unknown untaxed purchases",
+ "type": "boolean"
+}Input schema / properties / meUseTaxPurchasesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME line 30: purchases for use in Maine on which no sales tax was paid (5.5%)"
+}Input schema / properties / meUtilitiesAmountAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ME Schedule PTFC/STFC line 5c: the known amount of heat/utilities/furniture in the rent (omit if unknown → 15% of the rent)"
+}calculate_tax33 fields changedInput schema / properties / state / properties / wvAdditionsAdded value: +{
+ "description": "Schedule HEPTC-1 line 4a: increasing modifications, Schedule M line 59 (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvAdjustedGrossIncomeAdded value: +{
+ "description": "Schedule E line 4: West Virginia adjusted gross income, Form IT-140 line 4 (us.wv.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form IT-140 line 1 — the low-income exclusion and Social Security thresholds, and HEPTC-1 line 4 gross household income (us.wv.low_income_exclusion, us.wv.social_security_modification, us.wv.homestead_excess_property_tax_credit); the SCTC/HEPTC poverty tests use wvHouseholdIncome. May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvAlternativeTaxAdded value: +{
+ "description": "Schedule E line 7: the Rate Schedule tax on West Virginia taxable income minus the other-state income (line 6) (us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvDisabledVeteranCreditClaimedAdded value: +{
+ "description": "The Disabled Veteran real property tax credit (line 21B) is claimed — bars the SCTC and HEPTC (us.wv.senior_citizens_tax_credit, us.wv.homestead_excess_property_tax_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvEarnedIncomeAdded value: +{
+ "description": "Low-income exclusion worksheet line B: wages, salaries, tips, other employee compensation, and net self-employment earnings (us.wv.low_income_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form IT-140 exemption box (e): yourself (unless claimable as a dependent), spouse (MFJ), dependents, and the surviving-spouse extra exemption — $2,000 each; $500 when zero (us.wv.exemption_deduction)."
+}Input schema / properties / state / properties / wvFamilySizeAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule FTC-1 line 5: exemptions in boxes (a), (b), and (c) — the family size (0 → no credit; over 8 uses the size-8 column) (us.wv.family_tax_credit)."
+}Input schema / properties / state / properties / wvFederalAmtAdded value: +{
+ "description": "The filer paid federal alternative minimum tax — disqualifies the Family Tax Credit, SCTC, and HEPTC (us.wv.family_tax_credit, us.wv.senior_citizens_tax_credit, us.wv.homestead_excess_property_tax_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvFederalChildCareCreditAdded value: +{
+ "description": "Federal child and dependent care credit, Form 2441 — West Virginia allows 50% (us.wv.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvHouseholdIncomeAdded value: +{
+ "description": "Federal AGI (or income less Social Security when not required to file federally) tested against the SCTC / HEPTC poverty-guideline limits (us.wv.senior_citizens_tax_credit, us.wv.homestead_excess_property_tax_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvHouseholdSizeAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of people living in the household — the SCTC (150% of poverty) and HEPTC (300%) income limits (us.wv.senior_citizens_tax_credit, us.wv.homestead_excess_property_tax_credit)."
+}Input schema / properties / state / properties / wvIncomeNotOnLines35to46Added value: +{
+ "description": "Schedule M line 47 box (c): the person's income not reported on lines 35 through 46 (the rule caps it at $8,000) (us.wv.senior_citizen_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvLines29to34Added value: +{
+ "description": "Schedule M line 47 box (d): the person's lines 29 through 34 subtractions (obligation interest, law enforcement / police / fire / military retirement, the $2,000 PERS-TRS-federal modification, Social Security); for line 48 (us.wv.surviving_spouse_modification) pass lines 29-34 PLUS the line 47 modification, since the two together may not exceed $8,000. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvModifiedAgiAdded value: +{
+ "description": "Schedule FTC-1 line 4: federal AGI + increasing modifications + federal tax-exempt interest (us.wv.family_tax_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvMunicipalUseTaxPurchasesAdded value: +{
+ "description": "Schedule UT Part II: purchases used in a municipality that imposes a municipal use tax (us.wv.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvMunicipalUseTaxRateBpsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule UT Part II tax rate in basis points (50 for 0.5%, 100 for 1%) (us.wv.use_tax)."
+}Input schema / properties / state / properties / wvNontaxableSocialSecurityAdded value: +{
+ "description": "Schedule HEPTC-1 line 4d: Social Security, SSI, and SSDI received but not in federal AGI (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvOtherHouseholdIncomeAdded value: +{
+ "description": "Schedule HEPTC-1 line 4e: income of other household members who would file separately (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvOtherRecapCreditsAdded value: +{
+ "description": "Schedule E line 9: the sum of Tax Credit Recap lines 2 through 26 (Family Tax Credit, child care, business credits) (us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvOtherStateIncomeAdded value: +{
+ "description": "Schedule E line 3: net income derived from the other state included in West Virginia total income (us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvOtherStateTaxAdded value: +{
+ "description": "Schedule E line 1: income tax computed on the other state's 2025 return (not withholding) (us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvPropertyTaxPaidAdded value: +{
+ "description": "Schedule HEPTC-1 line 1: West Virginia property tax paid on the owner-occupied home in 2025, after discount and before interest (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvSeniorCitizenCreditAdded value: +{
+ "description": "Schedule HEPTC-1 line 2: the allowable Senior Citizens Tax Credit (subtracted from the property tax) (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvSeniorCitizenCreditAmountAdded value: +{
+ "description": "Schedule SCTC-A Part III line 2: the Senior Citizens Tax Credit computed on the Tax Division's mailed form (property tax on up to the first $20,000 of taxable assessed value) (us.wv.senior_citizens_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvSeniorOrDisabledAdded value: +{
+ "description": "The person for this Schedule M column is 65 or older on December 31 or certified permanently and totally disabled (us.wv.senior_citizen_modification).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvSurvivingSpouseEligibleAdded value: +{
+ "description": "Schedule M line 48: the filer is the unremarried surviving spouse of a decedent who was 65 or disabled, in the taxable year following the death (us.wv.surviving_spouse_modification).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvTaxBeforeCreditsAdded value: +{
+ "description": "Form IT-140 line 8 income tax (us.wv.family_tax_credit, us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvTaxExemptInterestAdded value: +{
+ "description": "Schedule HEPTC-1 line 4b: federal tax-exempt interest (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvTaxableSocialSecurityAdded value: +{
+ "description": "Schedule M line 34(c): Social Security benefits taxable federally (Form 1040 line 6b) for the column (us.wv.social_security_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvUseRateScheduleAdded value: +{
+ "description": "Compute Form IT-140 line 8 from the Rate Schedule at the exact income instead of the printed Tax Table (statuses 1, 2, 3, 5 under $100,000 use the table by instruction; MFS and $100,000+ always use the schedule) (us.wv.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvUseTaxPurchasesAdded value: +{
+ "description": "Schedule UT line 1: purchases subject to the 6% state use tax on which no sales tax was paid (us.wv.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvWorkersCompensationAdded value: +{
+ "description": "Schedule HEPTC-1 line 4c: earnings replacement insurance (workers' compensation) received (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return33 fields changedInput schema / properties / state / properties / wvAdditionsAdded value: +{
+ "description": "Schedule HEPTC-1 line 4a: increasing modifications, Schedule M line 59 (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvAdjustedGrossIncomeAdded value: +{
+ "description": "Schedule E line 4: West Virginia adjusted gross income, Form IT-140 line 4 (us.wv.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form IT-140 line 1 — the low-income exclusion and Social Security thresholds, and HEPTC-1 line 4 gross household income (us.wv.low_income_exclusion, us.wv.social_security_modification, us.wv.homestead_excess_property_tax_credit); the SCTC/HEPTC poverty tests use wvHouseholdIncome. May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvAlternativeTaxAdded value: +{
+ "description": "Schedule E line 7: the Rate Schedule tax on West Virginia taxable income minus the other-state income (line 6) (us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvDisabledVeteranCreditClaimedAdded value: +{
+ "description": "The Disabled Veteran real property tax credit (line 21B) is claimed — bars the SCTC and HEPTC (us.wv.senior_citizens_tax_credit, us.wv.homestead_excess_property_tax_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvEarnedIncomeAdded value: +{
+ "description": "Low-income exclusion worksheet line B: wages, salaries, tips, other employee compensation, and net self-employment earnings (us.wv.low_income_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form IT-140 exemption box (e): yourself (unless claimable as a dependent), spouse (MFJ), dependents, and the surviving-spouse extra exemption — $2,000 each; $500 when zero (us.wv.exemption_deduction)."
+}Input schema / properties / state / properties / wvFamilySizeAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule FTC-1 line 5: exemptions in boxes (a), (b), and (c) — the family size (0 → no credit; over 8 uses the size-8 column) (us.wv.family_tax_credit)."
+}Input schema / properties / state / properties / wvFederalAmtAdded value: +{
+ "description": "The filer paid federal alternative minimum tax — disqualifies the Family Tax Credit, SCTC, and HEPTC (us.wv.family_tax_credit, us.wv.senior_citizens_tax_credit, us.wv.homestead_excess_property_tax_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvFederalChildCareCreditAdded value: +{
+ "description": "Federal child and dependent care credit, Form 2441 — West Virginia allows 50% (us.wv.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvHouseholdIncomeAdded value: +{
+ "description": "Federal AGI (or income less Social Security when not required to file federally) tested against the SCTC / HEPTC poverty-guideline limits (us.wv.senior_citizens_tax_credit, us.wv.homestead_excess_property_tax_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvHouseholdSizeAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of people living in the household — the SCTC (150% of poverty) and HEPTC (300%) income limits (us.wv.senior_citizens_tax_credit, us.wv.homestead_excess_property_tax_credit)."
+}Input schema / properties / state / properties / wvIncomeNotOnLines35to46Added value: +{
+ "description": "Schedule M line 47 box (c): the person's income not reported on lines 35 through 46 (the rule caps it at $8,000) (us.wv.senior_citizen_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvLines29to34Added value: +{
+ "description": "Schedule M line 47 box (d): the person's lines 29 through 34 subtractions (obligation interest, law enforcement / police / fire / military retirement, the $2,000 PERS-TRS-federal modification, Social Security); for line 48 (us.wv.surviving_spouse_modification) pass lines 29-34 PLUS the line 47 modification, since the two together may not exceed $8,000. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvModifiedAgiAdded value: +{
+ "description": "Schedule FTC-1 line 4: federal AGI + increasing modifications + federal tax-exempt interest (us.wv.family_tax_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvMunicipalUseTaxPurchasesAdded value: +{
+ "description": "Schedule UT Part II: purchases used in a municipality that imposes a municipal use tax (us.wv.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvMunicipalUseTaxRateBpsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Schedule UT Part II tax rate in basis points (50 for 0.5%, 100 for 1%) (us.wv.use_tax)."
+}Input schema / properties / state / properties / wvNontaxableSocialSecurityAdded value: +{
+ "description": "Schedule HEPTC-1 line 4d: Social Security, SSI, and SSDI received but not in federal AGI (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvOtherHouseholdIncomeAdded value: +{
+ "description": "Schedule HEPTC-1 line 4e: income of other household members who would file separately (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvOtherRecapCreditsAdded value: +{
+ "description": "Schedule E line 9: the sum of Tax Credit Recap lines 2 through 26 (Family Tax Credit, child care, business credits) (us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvOtherStateIncomeAdded value: +{
+ "description": "Schedule E line 3: net income derived from the other state included in West Virginia total income (us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvOtherStateTaxAdded value: +{
+ "description": "Schedule E line 1: income tax computed on the other state's 2025 return (not withholding) (us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvPropertyTaxPaidAdded value: +{
+ "description": "Schedule HEPTC-1 line 1: West Virginia property tax paid on the owner-occupied home in 2025, after discount and before interest (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvSeniorCitizenCreditAdded value: +{
+ "description": "Schedule HEPTC-1 line 2: the allowable Senior Citizens Tax Credit (subtracted from the property tax) (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvSeniorCitizenCreditAmountAdded value: +{
+ "description": "Schedule SCTC-A Part III line 2: the Senior Citizens Tax Credit computed on the Tax Division's mailed form (property tax on up to the first $20,000 of taxable assessed value) (us.wv.senior_citizens_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvSeniorOrDisabledAdded value: +{
+ "description": "The person for this Schedule M column is 65 or older on December 31 or certified permanently and totally disabled (us.wv.senior_citizen_modification).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvSurvivingSpouseEligibleAdded value: +{
+ "description": "Schedule M line 48: the filer is the unremarried surviving spouse of a decedent who was 65 or disabled, in the taxable year following the death (us.wv.surviving_spouse_modification).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvTaxBeforeCreditsAdded value: +{
+ "description": "Form IT-140 line 8 income tax (us.wv.family_tax_credit, us.wv.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvTaxExemptInterestAdded value: +{
+ "description": "Schedule HEPTC-1 line 4b: federal tax-exempt interest (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvTaxableSocialSecurityAdded value: +{
+ "description": "Schedule M line 34(c): Social Security benefits taxable federally (Form 1040 line 6b) for the column (us.wv.social_security_modification). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvUseRateScheduleAdded value: +{
+ "description": "Compute Form IT-140 line 8 from the Rate Schedule at the exact income instead of the printed Tax Table (statuses 1, 2, 3, 5 under $100,000 use the table by instruction; MFS and $100,000+ always use the schedule) (us.wv.income_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / wvUseTaxPurchasesAdded value: +{
+ "description": "Schedule UT line 1: purchases subject to the 6% state use tax on which no sales tax was paid (us.wv.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wvWorkersCompensationAdded value: +{
+ "description": "Schedule HEPTC-1 line 4c: earnings replacement insurance (workers' compensation) received (us.wv.homestead_excess_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return57 fields changedInput schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne/id — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne/id/wv — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok",
- "ct",
- "ks",
- "ar",
- "nm",
- "ne",
- "id"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct",
+ "ks",
+ "ar",
+ "nm",
+ "ne",
+ "id",
+ "wv"
+]Input schema / properties / wvAbleContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 43: ABLE account contributions"
+}Input schema / properties / wvActiveDutyPayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M lines 36-37: qualifying active duty (Title 10 contingency operations) and active military separation pay"
+}Input schema / properties / wvAmendedPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 22 (amended only): amount paid with the original return"
+}Input schema / properties / wvAmendedRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 11 (amended only): overpayment previously refunded or credited"
+}Input schema / properties / wvBuildWvCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 20: Build WV Property Value Adjustment refundable credit (Schedule PVA-2)"
+}Input schema / properties / wvCreditForwardAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 27: overpayment to credit to 2026 estimated tax"
+}Input schema / properties / wvDisabledVeteranPropertyTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 21B: real property tax timely paid on a disabled veteran's (or eligible widowed spouse's) homestead — 100% refundable (§ 11-13MM-4); bars the SCTC and HEPTC"
+}Input schema / properties / wvDonationsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 26: donations to the Children's Trust Fund, Division of Veterans Assistance, and State Veterans Cemetery"
+}Input schema / properties / wvEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 5 low-income exclusion: earned income (wages, salaries, tips, net self-employment) — REQUIRED when federal AGI is $10,000 or less ($5,000 MFS) for the exclusion to be computed"
+}Input schema / properties / wvFederalAmtAdded value: +{
+ "description": "WV: the filer paid federal alternative minimum tax — no Family Tax Credit, SCTC, or HEPTC",
+ "type": "boolean"
+}Input schema / properties / wvFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Recap line 18: the federal child and dependent care credit (Form 2441) — 50% nonrefundable"
+}Input schema / properties / wvFederalLawEnforcementRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 30 column A: retired federal law enforcement officer / firefighter retirement benefits (100%)"
+}Input schema / properties / wvFederalTaxExemptInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule FTC-1 line 3 / HEPTC-1 line 4b: federal tax-exempt interest not already in line 2"
+}Input schema / properties / wvGamblingLossesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 46: gambling losses (not more than winnings; federal itemizers only)"
+}Input schema / properties / wvHouseholdIncomeLessSocialSecurityAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV SCTC / HEPTC: income excluding Social Security when not required to file federally"
+}Input schema / properties / wvHouseholdSizeAdded value: +{
+ "description": "WV SCTC / HEPTC: number of people living in the household (defaults to 1 + spouse + dependents)",
+ "type": "integer"
+}Input schema / properties / wvJumpstartDepositsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 44: Jumpstart Savings Program deposits — the composer caps at $25,000"
+}Input schema / properties / wvLongTermCarePremiumsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 41: long-term care insurance premiums"
+}Input schema / properties / wvMilitaryRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 32 column A: military retirement including survivorship annuities (100%)"
+}Input schema / properties / wvMotorVehicleTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 21A: personal property tax timely paid to the sheriff on owned motor vehicles — 100% refundable credit (§ 11-13MM-3; Schedule MV-1)"
+}Input schema / properties / wvMunicipalUseTaxPurchasesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule UT Part II: purchases used in a municipality with a municipal use tax"
+}Input schema / properties / wvMunicipalUseTaxRateAdded value: +{
+ "description": "WV Schedule UT Part II: municipal use tax rate in percent (0.5 or 1)",
+ "type": "number"
+}Input schema / properties / wvNonFamilyAdoptionCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 17: Non-Family Adoption Tax Credit (Schedule NFA-1)"
+}Input schema / properties / wvNonWvBondInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 52: interest or dividends on non-West Virginia state and local bonds (added)"
+}Input schema / properties / wvNontaxableSocialSecurityAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule HEPTC-1 line 4d: Social Security, SSI, and SSDI received but not in federal AGI"
+}Input schema / properties / wvNotRequiredToFileFederallyAdded value: +{
+ "description": "WV SCTC / HEPTC eligibility: not required to file a federal return — the poverty-guideline test then uses income less Social Security benefits (pass wvHouseholdIncomeLessSocialSecurity)",
+ "type": "boolean"
+}Input schema / properties / wvOtherHouseholdIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule HEPTC-1 line 4e: income of other household members who would file separately"
+}Input schema / properties / wvOtherStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule E line 3: net income derived from the other state included in West Virginia total income"
+}Input schema / properties / wvOtherStateTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule E line 1: income tax computed on the other state's return (not withholding; not city taxes) — attach nothing, keep the return"
+}Input schema / properties / wvPersTrsFederalRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 33 column A: West Virginia PERS / Teachers' Retirement plus federal retirement not on line 30 — the composer caps the combined amount at $2,000 per person"
+}Input schema / properties / wvPoliceFireRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 31 column A: West Virginia state or local police, deputy sheriffs', or firemen's retirement (100%, excluding PERS)"
+}Input schema / properties / wvPropertyTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule HEPTC-1 line 1: West Virginia property tax paid on the owner-occupied home in 2025 (after discount, before interest; Class 2 receipt required)"
+}Input schema / properties / wvRailroadRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 40: Railroad Retirement Board income in federal AGI (100%)"
+}Input schema / properties / wvSeniorCitizenCreditAmountAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 18: the Senior Citizens Tax Credit from the mailed Schedule SCTC-A Part III line 2 (Homestead Exemption participants; federal AGI ≤ 150% of poverty)"
+}Input schema / properties / wvSmallBusinessPropertyTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 21C: personal property tax timely paid by an eligible small business (≤ $1 million appraised), net of vehicle tax claimed in 21A — 50% credit (§ 11-13MM-5)"
+}Input schema / properties / wvSmart529ContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 39: SMART529 / Prepaid Tuition Trust contributions (no cap; annual statement required)"
+}Input schema / properties / wvSpouseAge65OrDisabledAdded value: +{
+ "description": "WV Schedule M line 47 column B: the spouse is 65 or older or certified disabled (joint returns)",
+ "type": "boolean"
+}Input schema / properties / wvSpouseClaimedAsDependentAdded value: +{
+ "description": "WV exemption box (b): the spouse can be claimed as a dependent on another return — no spouse exemption",
+ "type": "boolean"
+}Input schema / properties / wvSpouseFederalLawEnforcementRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 30 column B (spouse)"
+}Input schema / properties / wvSpouseIncomeNotOnLines35to46Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 47 box (c) column B (defaults to $8,000)"
+}Input schema / properties / wvSpouseMilitaryRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 32 column B (spouse)"
+}Input schema / properties / wvSpousePersTrsFederalRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 33 column B (spouse), capped at $2,000"
+}Input schema / properties / wvSpousePoliceFireRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 31 column B (spouse)"
+}Input schema / properties / wvSpouseTaxableSocialSecurityAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 34 column B: the SPOUSE's share of federally taxable Social Security (taxableSocialSecurity is the joint total; the taxpayer's column is the remainder)"
+}Input schema / properties / wvSpouseUsInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 29 column B (spouse)"
+}Input schema / properties / wvStateRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 38: state and local income tax refunds included in federal income"
+}Input schema / properties / wvSurvivingSpouseExemptionAdded value: +{
+ "description": "WV exemption box (d): an unremarried surviving spouse in one of the two taxable years after the year of the spouse's death — one extra $2,000 exemption",
+ "type": "boolean"
+}Input schema / properties / wvSurvivingSpouseModificationAdded value: +{
+ "description": "WV Schedule M line 48: unremarried surviving spouse of a decedent who was 65 or disabled, in the taxable year after the death — up to $8,000 less lines 29-34",
+ "type": "boolean"
+}Input schema / properties / wvTaxpayerAge65OrDisabledAdded value: +{
+ "description": "WV Schedule M line 47 column A: the taxpayer is 65 or older on December 31 or certified permanently and totally disabled — up to $8,000 modification net of lines 29-34",
+ "type": "boolean"
+}Input schema / properties / wvTaxpayerIncomeNotOnLines35to46Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 47 box (c) column A: the taxpayer's income not reported on lines 35-46 (defaults to $8,000, the cap)"
+}Input schema / properties / wvUnderpaymentPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 12: Form IT-210 underpayment penalty"
+}Input schema / properties / wvUsInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule M line 29 column A: interest/dividends on U.S. and West Virginia obligations exempt from state tax"
+}Input schema / properties / wvUseRateScheduleAdded value: +{
+ "description": "WV line 8: compute from the Rate Schedule at the exact income instead of the printed Tax Table (single/HOH/MFJ/widow(er) under $100,000 use the table by instruction; MFS and $100,000+ always use the schedule)",
+ "type": "boolean"
+}Input schema / properties / wvUseTaxPurchasesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV line 13 / Schedule UT line 1: purchases subject to the 6% state use tax on which no sales tax was paid (net of credit for sales tax paid elsewhere)"
+}Input schema / properties / wvWorkersCompensationAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "WV Schedule HEPTC-1 line 4c: workers' compensation received"
+}calculate_tax52 fields changedInput schema / properties / state / properties / idAdjustedIncomeAdded value: +{
+ "description": "Form 39R Part C line 3: Idaho adjusted income, Form 40 line 11 (us.id.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idAgeBlindBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 40 lines 12a-12b boxes checked (you 65+, you blind, spouse 65+, spouse blind; must match the federal return) — $2,000 each for single/HOH, $1,600 each for MFJ/QSS/MFS (us.id.standard_deduction)."
+}Input schema / properties / state / properties / idAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form 40 line 7 — the 7.5% medical floor in the health/LTC worksheets (us.id.health_insurance_deduction, us.id.long_term_care_deduction). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idBlindAdded value: +{
+ "description": "You or your spouse are legally blind at the end of the tax year — no $10 permanent building fund tax (us.id.permanent_building_fund_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idBusinessCreditsAdded value: +{
+ "description": "Form 40 line 23 / Form 44 Part I: business income tax credits — reduce the tax available for the Part D and child tax credits. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idChildCareExpensesAdded value: +{
+ "description": "Form 39R child care worksheet line 1: qualified expenses paid, excluding employer-paid or excluded amounts (us.id.child_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idContributionCreditsAdded value: +{
+ "description": "Form 40 line 22: total Form 39R Part D credits — reduces the tax available for the child tax credit (us.id.child_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idDependentCareBenefitsExcludedAdded value: +{
+ "description": "Form 39R child care worksheet line 3: excluded dependent care benefits from federal Form 2441 Part III (us.id.child_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEarnedIncomeAdded value: +{
+ "description": "Earned income (wages, salaries, tips, professional fees, taxable scholarships) — the dependent-filer standard deduction (us.id.standard_deduction) and the Form 39R child care worksheet line 5 (us.id.child_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEducationalContributionsAdded value: +{
+ "description": "Form 39R Part D line 1: cash contributed to qualified Idaho educational entities (us.id.educational_contribution_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEducationalCreditAdded value: +{
+ "description": "Form 39R Part D line 1 educational entity credit already allowed — reduces the tax available for the youth/rehab and live organ credits. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEnergyDeviceCost2022Added value: +{
+ "description": "Form 39R line 5d: cost of an alternative energy device placed in service in 2022 (20%). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEnergyDeviceCost2023Added value: +{
+ "description": "Form 39R line 5c: cost of an alternative energy device placed in service in 2023 (20%). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEnergyDeviceCost2024Added value: +{
+ "description": "Form 39R line 5b: cost of an alternative energy device placed in service in 2024 (20%). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEnergyDeviceCost2025Added value: +{
+ "description": "Form 39R line 5a: cost of an alternative energy device placed in service in 2025 (40%) (us.id.alternative_energy_device_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idFederalItemizedDeductionsAdded value: +{
+ "description": "Form 40 line 13: total federal itemized deductions, Schedule A line 17 (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idFoodCreditPartialMonthsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Food Tax Credit worksheet: total qualified months across household members qualified for only part of the year — $12.92 each (us.id.food_tax_credit)."
+}Input schema / properties / state / properties / idFoodCreditPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Food Tax Credit worksheet: household members (you, spouse, resident dependents) qualified for all twelve months — $155 each (us.id.food_tax_credit)."
+}Input schema / properties / state / properties / idForeignTaxCreditAdded value: +{
+ "description": "Federal foreign tax credit claimed — Idaho allows it as an addition to itemized deductions (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idHealthPremiumsDeductedElsewhereAdded value: +{
+ "description": "Health/LTC worksheet line 9: health insurance costs deducted elsewhere on the federal return (e.g. self-employed health insurance) (us.id.health_insurance_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idHealthPremiumsPaidAdded value: +{
+ "description": "Health/LTC worksheet line 7: total health insurance premiums paid for you, your spouse, and dependents, excluding pre-tax/cafeteria-plan and business-deducted premiums (us.id.health_insurance_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idHomeFamilyMembersAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 39R Part E: family members age 65+ (not you or your spouse) or with a developmental disability for whom you maintained a home all year and provided over half the support — $100 each, at most $300 (us.id.home_for_family_member_credit)."
+}Input schema / properties / state / properties / idHomeFamilyPartialMonthsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 39R Part E: total months of home maintenance for partially-qualified family members — $8.33 each (us.id.home_for_family_member_credit)."
+}Input schema / properties / state / properties / idInvestmentTaxCreditAdded value: +{
+ "description": "Form 44 Part I line 1: Idaho investment tax credit (Form 49) — the only Form 44 line that reduces the tax available for the youth/rehabilitation facility credit (us.id.youth_rehab_contribution_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idItemizingForIdahoAdded value: +{
+ "description": "The filer uses itemized deductions on Form 40 line 17 (line 15 exceeds line 16) — the health and long-term care worksheets then allocate the federal medical deduction (us.id.health_insurance_deduction, us.id.long_term_care_deduction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idLtcDeductedElsewhereAdded value: +{
+ "description": "Health/LTC worksheet line 14: long-term care premiums deducted elsewhere on the federal return (us.id.long_term_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idLtcPremiumsPaidAdded value: +{
+ "description": "Health/LTC worksheet line 11: total qualified long-term care insurance premiums paid (us.id.long_term_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idNetCapitalGainAdded value: +{
+ "description": "Capital gain net income from all property included in taxable income — caps the Idaho capital gains deduction (us.id.capital_gains_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idOrganDonationExpensesAdded value: +{
+ "description": "Form 39R Part D line 3: unreimbursed travel, lodging, and lost wages for a live organ donation (us.id.live_organ_donation_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idOtherStateCreditAdded value: +{
+ "description": "Form 40 line 21 credit for income tax paid to other states — reduces the tax available for the Part D and child tax credits. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idOtherStateIncomeAdded value: +{
+ "description": "Form 39R Part C line 2: federal AGI earned in the other state and taxed by both states, adjusted for Idaho modifications (us.id.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idOtherStateTaxDueAdded value: +{
+ "description": "Form 39R Part C line 6: the other state's tax due from its table or schedule minus its income tax credits (not SALT workaround payments) (us.id.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idPersonalPropertyTaxesAdded value: +{
+ "description": "Federal Schedule A line 5c: state and local personal property taxes (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idQualifiedCapitalGainAdded value: +{
+ "description": "Form CG: capital gain net income from qualified Idaho property (real property held 12+ months, etc.) (us.id.capital_gains_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 40 line 24 worksheet line 1: qualifying children (IRC § 24(c)) age 16 or under on December 31 — $205 each (us.id.child_tax_credit)."
+}Input schema / properties / state / properties / idQualifyingRetirementBenefitsAdded value: +{
+ "description": "Form 39R line 8e: qualifying CSRS/FSRDS, Idaho firefighter, Idaho city police, or military retirement benefits included in federal income (us.id.retirement_benefits_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idRailroadBenefitsAdded value: +{
+ "description": "Form 39R line 8b: federal Railroad Retirement benefits received (RRB-1099 Box 5 net SSEB, RRB-1099-R Box 7 less Box 8) (us.id.retirement_benefits_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idRealEstateTaxesAdded value: +{
+ "description": "Federal Schedule A line 5b: state and local real estate taxes (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idReceivedPublicAssistanceAdded value: +{
+ "description": "Form 40 line 31 box: receiving Idaho public assistance payments at the end of the tax year (not food stamps or WIC) — no $10 permanent building fund tax (us.id.permanent_building_fund_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idRequiredToFileAdded value: +{
+ "description": "Idaho requires this return (gross income at or above the filing threshold for the filing status) — the $10 permanent building fund tax applies (us.id.permanent_building_fund_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idRetirementEligibleAdded value: +{
+ "description": "The filer (or spouse) meets the § 63-3022A age/disability test — 65, or 62 and disabled; military retirees: disabled, 62, or employed with income requiring a federal return (us.id.retirement_benefits_deduction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idSaltAllowedAdded value: +{
+ "description": "Federal Schedule A line 5e: state and local taxes allowed after the federal cap — used when line 5d exceeds $40,000 ($20,000 MFS) (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSaltIncomeOrSalesTaxesAdded value: +{
+ "description": "Federal Schedule A line 5a: state and local income taxes or general sales taxes (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSchAHealthPremiumsAdded value: +{
+ "description": "Health/LTC worksheet line 1: health insurance premiums claimed on federal Schedule A (us.id.health_insurance_deduction, us.id.long_term_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSchALtcPremiumsAdded value: +{
+ "description": "Health/LTC worksheet line 2: long-term care premiums claimed on federal Schedule A. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSchAOtherMedicalAdded value: +{
+ "description": "Health/LTC worksheet line 3: other medical expenses claimed on federal Schedule A. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSocialSecurityBenefitsAdded value: +{
+ "description": "Form 39R line 8c: Social Security benefits received, SSA-1099 Box 5 (gross, not the taxable portion) (us.id.retirement_benefits_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSpouseEarnedIncomeAdded value: +{
+ "description": "Spouse's earned income on a joint return — Form 39R child care worksheet line 6 (us.id.child_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idTaxBeforeCreditsAdded value: +{
+ "description": "Form 40 line 20 Idaho income tax — the base for the credit limits (us.id.child_tax_credit, us.id.other_state_credit, us.id.educational_contribution_credit, us.id.youth_rehab_contribution_credit, us.id.live_organ_donation_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idUseTaxPurchasesAdded value: +{
+ "description": "Form 40 line 28: purchases on which no Idaho sales tax was paid (online, mail order, out-of-state) — 6% (us.id.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idYouthContributionsAdded value: +{
+ "description": "Form 39R Part D line 2: cash or goods contributed to Idaho youth and rehabilitation facilities, centers for independent living, or licensed substance abuse centers (us.id.youth_rehab_contribution_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idYouthCreditAdded value: +{
+ "description": "Form 39R Part D line 2 youth and rehabilitation facility credit already allowed — reduces the tax available for the live organ donation credit. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return52 fields changedInput schema / properties / state / properties / idAdjustedIncomeAdded value: +{
+ "description": "Form 39R Part C line 3: Idaho adjusted income, Form 40 line 11 (us.id.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idAgeBlindBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 40 lines 12a-12b boxes checked (you 65+, you blind, spouse 65+, spouse blind; must match the federal return) — $2,000 each for single/HOH, $1,600 each for MFJ/QSS/MFS (us.id.standard_deduction)."
+}Input schema / properties / state / properties / idAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form 40 line 7 — the 7.5% medical floor in the health/LTC worksheets (us.id.health_insurance_deduction, us.id.long_term_care_deduction). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idBlindAdded value: +{
+ "description": "You or your spouse are legally blind at the end of the tax year — no $10 permanent building fund tax (us.id.permanent_building_fund_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idBusinessCreditsAdded value: +{
+ "description": "Form 40 line 23 / Form 44 Part I: business income tax credits — reduce the tax available for the Part D and child tax credits. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idChildCareExpensesAdded value: +{
+ "description": "Form 39R child care worksheet line 1: qualified expenses paid, excluding employer-paid or excluded amounts (us.id.child_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idContributionCreditsAdded value: +{
+ "description": "Form 40 line 22: total Form 39R Part D credits — reduces the tax available for the child tax credit (us.id.child_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idDependentCareBenefitsExcludedAdded value: +{
+ "description": "Form 39R child care worksheet line 3: excluded dependent care benefits from federal Form 2441 Part III (us.id.child_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEarnedIncomeAdded value: +{
+ "description": "Earned income (wages, salaries, tips, professional fees, taxable scholarships) — the dependent-filer standard deduction (us.id.standard_deduction) and the Form 39R child care worksheet line 5 (us.id.child_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEducationalContributionsAdded value: +{
+ "description": "Form 39R Part D line 1: cash contributed to qualified Idaho educational entities (us.id.educational_contribution_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEducationalCreditAdded value: +{
+ "description": "Form 39R Part D line 1 educational entity credit already allowed — reduces the tax available for the youth/rehab and live organ credits. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEnergyDeviceCost2022Added value: +{
+ "description": "Form 39R line 5d: cost of an alternative energy device placed in service in 2022 (20%). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEnergyDeviceCost2023Added value: +{
+ "description": "Form 39R line 5c: cost of an alternative energy device placed in service in 2023 (20%). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEnergyDeviceCost2024Added value: +{
+ "description": "Form 39R line 5b: cost of an alternative energy device placed in service in 2024 (20%). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idEnergyDeviceCost2025Added value: +{
+ "description": "Form 39R line 5a: cost of an alternative energy device placed in service in 2025 (40%) (us.id.alternative_energy_device_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idFederalItemizedDeductionsAdded value: +{
+ "description": "Form 40 line 13: total federal itemized deductions, Schedule A line 17 (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idFoodCreditPartialMonthsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Food Tax Credit worksheet: total qualified months across household members qualified for only part of the year — $12.92 each (us.id.food_tax_credit)."
+}Input schema / properties / state / properties / idFoodCreditPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Food Tax Credit worksheet: household members (you, spouse, resident dependents) qualified for all twelve months — $155 each (us.id.food_tax_credit)."
+}Input schema / properties / state / properties / idForeignTaxCreditAdded value: +{
+ "description": "Federal foreign tax credit claimed — Idaho allows it as an addition to itemized deductions (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idHealthPremiumsDeductedElsewhereAdded value: +{
+ "description": "Health/LTC worksheet line 9: health insurance costs deducted elsewhere on the federal return (e.g. self-employed health insurance) (us.id.health_insurance_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idHealthPremiumsPaidAdded value: +{
+ "description": "Health/LTC worksheet line 7: total health insurance premiums paid for you, your spouse, and dependents, excluding pre-tax/cafeteria-plan and business-deducted premiums (us.id.health_insurance_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idHomeFamilyMembersAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 39R Part E: family members age 65+ (not you or your spouse) or with a developmental disability for whom you maintained a home all year and provided over half the support — $100 each, at most $300 (us.id.home_for_family_member_credit)."
+}Input schema / properties / state / properties / idHomeFamilyPartialMonthsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 39R Part E: total months of home maintenance for partially-qualified family members — $8.33 each (us.id.home_for_family_member_credit)."
+}Input schema / properties / state / properties / idInvestmentTaxCreditAdded value: +{
+ "description": "Form 44 Part I line 1: Idaho investment tax credit (Form 49) — the only Form 44 line that reduces the tax available for the youth/rehabilitation facility credit (us.id.youth_rehab_contribution_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idItemizingForIdahoAdded value: +{
+ "description": "The filer uses itemized deductions on Form 40 line 17 (line 15 exceeds line 16) — the health and long-term care worksheets then allocate the federal medical deduction (us.id.health_insurance_deduction, us.id.long_term_care_deduction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idLtcDeductedElsewhereAdded value: +{
+ "description": "Health/LTC worksheet line 14: long-term care premiums deducted elsewhere on the federal return (us.id.long_term_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idLtcPremiumsPaidAdded value: +{
+ "description": "Health/LTC worksheet line 11: total qualified long-term care insurance premiums paid (us.id.long_term_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idNetCapitalGainAdded value: +{
+ "description": "Capital gain net income from all property included in taxable income — caps the Idaho capital gains deduction (us.id.capital_gains_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idOrganDonationExpensesAdded value: +{
+ "description": "Form 39R Part D line 3: unreimbursed travel, lodging, and lost wages for a live organ donation (us.id.live_organ_donation_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idOtherStateCreditAdded value: +{
+ "description": "Form 40 line 21 credit for income tax paid to other states — reduces the tax available for the Part D and child tax credits. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idOtherStateIncomeAdded value: +{
+ "description": "Form 39R Part C line 2: federal AGI earned in the other state and taxed by both states, adjusted for Idaho modifications (us.id.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idOtherStateTaxDueAdded value: +{
+ "description": "Form 39R Part C line 6: the other state's tax due from its table or schedule minus its income tax credits (not SALT workaround payments) (us.id.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idPersonalPropertyTaxesAdded value: +{
+ "description": "Federal Schedule A line 5c: state and local personal property taxes (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idQualifiedCapitalGainAdded value: +{
+ "description": "Form CG: capital gain net income from qualified Idaho property (real property held 12+ months, etc.) (us.id.capital_gains_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 40 line 24 worksheet line 1: qualifying children (IRC § 24(c)) age 16 or under on December 31 — $205 each (us.id.child_tax_credit)."
+}Input schema / properties / state / properties / idQualifyingRetirementBenefitsAdded value: +{
+ "description": "Form 39R line 8e: qualifying CSRS/FSRDS, Idaho firefighter, Idaho city police, or military retirement benefits included in federal income (us.id.retirement_benefits_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idRailroadBenefitsAdded value: +{
+ "description": "Form 39R line 8b: federal Railroad Retirement benefits received (RRB-1099 Box 5 net SSEB, RRB-1099-R Box 7 less Box 8) (us.id.retirement_benefits_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idRealEstateTaxesAdded value: +{
+ "description": "Federal Schedule A line 5b: state and local real estate taxes (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idReceivedPublicAssistanceAdded value: +{
+ "description": "Form 40 line 31 box: receiving Idaho public assistance payments at the end of the tax year (not food stamps or WIC) — no $10 permanent building fund tax (us.id.permanent_building_fund_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idRequiredToFileAdded value: +{
+ "description": "Idaho requires this return (gross income at or above the filing threshold for the filing status) — the $10 permanent building fund tax applies (us.id.permanent_building_fund_tax).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idRetirementEligibleAdded value: +{
+ "description": "The filer (or spouse) meets the § 63-3022A age/disability test — 65, or 62 and disabled; military retirees: disabled, 62, or employed with income requiring a federal return (us.id.retirement_benefits_deduction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / idSaltAllowedAdded value: +{
+ "description": "Federal Schedule A line 5e: state and local taxes allowed after the federal cap — used when line 5d exceeds $40,000 ($20,000 MFS) (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSaltIncomeOrSalesTaxesAdded value: +{
+ "description": "Federal Schedule A line 5a: state and local income taxes or general sales taxes (us.id.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSchAHealthPremiumsAdded value: +{
+ "description": "Health/LTC worksheet line 1: health insurance premiums claimed on federal Schedule A (us.id.health_insurance_deduction, us.id.long_term_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSchALtcPremiumsAdded value: +{
+ "description": "Health/LTC worksheet line 2: long-term care premiums claimed on federal Schedule A. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSchAOtherMedicalAdded value: +{
+ "description": "Health/LTC worksheet line 3: other medical expenses claimed on federal Schedule A. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSocialSecurityBenefitsAdded value: +{
+ "description": "Form 39R line 8c: Social Security benefits received, SSA-1099 Box 5 (gross, not the taxable portion) (us.id.retirement_benefits_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idSpouseEarnedIncomeAdded value: +{
+ "description": "Spouse's earned income on a joint return — Form 39R child care worksheet line 6 (us.id.child_care_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idTaxBeforeCreditsAdded value: +{
+ "description": "Form 40 line 20 Idaho income tax — the base for the credit limits (us.id.child_tax_credit, us.id.other_state_credit, us.id.educational_contribution_credit, us.id.youth_rehab_contribution_credit, us.id.live_organ_donation_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idUseTaxPurchasesAdded value: +{
+ "description": "Form 40 line 28: purchases on which no Idaho sales tax was paid (online, mail order, out-of-state) — 6% (us.id.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idYouthContributionsAdded value: +{
+ "description": "Form 39R Part D line 2: cash or goods contributed to Idaho youth and rehabilitation facilities, centers for independent living, or licensed substance abuse centers (us.id.youth_rehab_contribution_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / idYouthCreditAdded value: +{
+ "description": "Form 39R Part D line 2 youth and rehabilitation facility credit already allowed — reduces the tax available for the live organ donation credit. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return71 fields changedInput schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne/id — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / idAdoptionExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 12: legal and medical adoption expenses — the composer caps at $10,000 per adoption (pass the per-adoption total)"
+}Input schema / properties / idApplyToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 56: part of the overpayment to apply to 2026 estimated tax"
+}Input schema / properties / idBlindFilerAdded value: +{
+ "description": "ID line 31: you or your spouse are legally blind at year end — no $10 permanent building fund tax (§ 63-3086); also check the line 12b box via ageOrBlindBoxes",
+ "type": "boolean"
+}Input schema / properties / idBusinessCreditsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 23: Form 44 Part I business income tax credits"
+}Input schema / properties / idChildCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 6: qualified child/dependent care expenses paid (deduction ≤ $12,000 less excluded benefits, ≤ each spouse's earned income; pass idEarnedIncome)"
+}Input schema / properties / idCollegeSavingsContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 14: Idaho College Savings Program (IDeal) contributions — capped at $6,000 ($12,000 MFJ)"
+}Input schema / properties / idCreditRecaptureAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID lines 29-30: recapture of income tax credits (Form 44 Part II) and of the qualified investment exemption (Form 49ER)"
+}Input schema / properties / idDependentCareBenefitsExcludedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R child care worksheet line 3: excluded dependent care benefits (Form 2441 Part III)"
+}Input schema / properties / idDonateFoodCreditAdded value: +{
+ "description": "ID line 43: donate the entire Food Tax Credit to the Cooperative Welfare Fund (line 43 = $0)",
+ "type": "boolean"
+}Input schema / properties / idDonationsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID lines 33-40: total voluntary donations (Nongame Wildlife, Children's Trust, Special Olympics, Guard and Reserve, Red Cross, Veterans, Food Bank, Opportunity Scholarship)"
+}Input schema / properties / idEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID earned income — REQUIRED for a filer claimable as a dependent (the standard deduction is the larger of $1,350 or earned income + $450, capped) and for the Form 39R child care deduction"
+}Input schema / properties / idEducationalContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part D line 1: cash donated to qualified Idaho educational entities (50% credit, ≤ 50% of tax, ≤ $500 / $1,000 joint)"
+}Input schema / properties / idEnergyDeviceCost2022Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R line 5d: device cost, 2022 (20%)"
+}Input schema / properties / idEnergyDeviceCost2023Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R line 5c: device cost, 2023 (20%)"
+}Input schema / properties / idEnergyDeviceCost2024Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R line 5b: device cost, 2024 (20%)"
+}Input schema / properties / idEnergyDeviceCost2025Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R line 5a: alternative energy device cost placed in service in 2025 (40%, ≤ $5,000)"
+}Input schema / properties / idEntityPaymentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 48: Idaho tax paid or withheld by a pass-through entity or ABE (Form ID K-1)"
+}Input schema / properties / idFederalItemizedAdded value: +{
+ "description": "ID lines 13-17: the filer itemized on the federal return — Idaho then uses the LARGER of the federal standard deduction and federal itemized deductions minus state and local income or sales taxes (pass idFederalItemizedDeductions and the Schedule A tax lines)",
+ "type": "boolean"
+}Input schema / properties / idFederalItemizedDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 13: federal Schedule A line 17 total itemized deductions"
+}Input schema / properties / idFederalNolDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part A line 1: federal NOL deduction included on Form 40 line 7 (added back)"
+}Input schema / properties / idFirstTimeHomeBuyerContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 22: first-time home buyer savings account contributions plus interest — capped at $15,000 ($30,000 MFJ)"
+}Input schema / properties / idFoodCreditExcludedPersonsAdded value: +{
+ "description": "ID line 43: household members who do NOT qualify for the Food Tax Credit at all (e.g. nonresident dependents, full-year food stamp recipients) — subtracted from the automatic full-year count",
+ "type": "integer"
+}Input schema / properties / idFoodCreditPartialMonthsAdded value: +{
+ "description": "ID line 43 Food Tax Credit: total qualified months across household members qualified only part of the year ($12.92 each) — months on food stamps, incarcerated, or nonresident don't qualify; pass idFoodCreditPartialPersons with it",
+ "type": "integer"
+}Input schema / properties / idFoodCreditPartialPersonsAdded value: +{
+ "description": "ID line 43: how many household members are qualified only part of the year (they are removed from the $155 full-year count and paid $12.92 per month via idFoodCreditPartialMonths); defaults to 1 when partial months are given",
+ "type": "integer"
+}Input schema / properties / idForeignTaxCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID: federal foreign tax credit claimed — Idaho adds it to itemized deductions (no matching credit)"
+}Input schema / properties / idFuelsTaxDueAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 27: fuels use tax due from Form 75"
+}Input schema / properties / idFuelsTaxRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 45: special fuels / gasoline tax refund from Form 75"
+}Input schema / properties / idHealthPremiumsDeductedElsewhereAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID health worksheet line 9: health insurance costs deducted elsewhere on the federal return (self-employed health insurance)"
+}Input schema / properties / idHealthPremiumsPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 18: health insurance premiums paid for you, spouse, and dependents, excluding pre-tax/cafeteria-plan and business-deducted premiums (worksheet line 7)"
+}Input schema / properties / idHomeFamilyDeductionAdded value: +{
+ "description": "ID: take the $1,000-per-member Form 39R Part B line 15 deduction instead of the $100 Part E credit",
+ "type": "boolean"
+}Input schema / properties / idHomeFamilyMembersAdded value: +{
+ "description": "ID Form 39R Part E / Part B line 15: family members age 65+ (not you or your spouse) or with a developmental disability for whom you maintained a home all year and provided over half the support — $100 credit each (max $300), or the $1,000 deduction each (max 3) with idHomeFamilyDeduction",
+ "type": "integer"
+}Input schema / properties / idHomeFamilyPartialMonthsAdded value: +{
+ "description": "ID Form 39R Part E: total months for partially-qualified family members ($8.33 credit or $83.33 deduction per month)",
+ "type": "integer"
+}Input schema / properties / idIdahoNolCarryoverAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 1: Idaho net operating loss carryover/carryback (Form 56)"
+}Input schema / properties / idInvestmentTaxCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 44 Part I line 1: investment tax credit (Form 49) — the youth/rehab facility credit's remaining-tax limit subtracts this line specifically"
+}Input schema / properties / idLtcDeductedElsewhereAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID LTC worksheet line 14: long-term care premiums deducted elsewhere on the federal return"
+}Input schema / properties / idLtcPremiumsPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 19: qualified long-term care insurance premiums paid (worksheet line 11)"
+}Input schema / properties / idMedicalSavingsContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 13: Idaho medical savings account contributions plus interest — capped at $10,000 ($20,000 MFJ)"
+}Input schema / properties / idMilitaryPayOutsideIdahoAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 11: active-duty military pay earned outside Idaho (120+ consecutive days)"
+}Input schema / properties / idNetCapitalGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID: capital gain net income from all property included in taxable income — caps the capital gains deduction"
+}Input schema / properties / idNonIdahoBondInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part A line 3: interest and dividends from non-Idaho state and local bonds, net of expenses (added)"
+}Input schema / properties / idOrganDonationExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part D line 3: unreimbursed live organ donation travel, lodging, and lost wages (≤ $5,000; five-year carryover)"
+}Input schema / properties / idOtherRefundableCreditsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 49: Tax Reimbursement Incentive credit and Claim of Right credit"
+}Input schema / properties / idOtherStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part C line 2: federal AGI earned in the other state and taxed by both states, adjusted for Idaho modifications"
+}Input schema / properties / idOtherStateTaxDueAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part C line 6: the other state's tax due minus its income tax credits (not withholding; not SALT workaround payments) — attach that return"
+}Input schema / properties / idParentalChoiceCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 42: approved Parental Choice Tax Credit qualified expenses (refundable, up to the approved amount)"
+}Input schema / properties / idPenaltyAndInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 52: penalty and interest (interest 6% for 2026; 10% penalty on a nonqualified Idaho MSA withdrawal under 59½)"
+}Input schema / properties / idPersonalPropertyTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 14 input: Schedule A line 5c personal property taxes"
+}Input schema / properties / idPriorYearCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 53: nonrefundable credit from a prior year return (Form 44)"
+}Input schema / properties / idQbiDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 18: federal Form 1040 lines 13a + 13b (qualified business income deduction and Schedule 1-A deductions) — subtracted from Idaho income"
+}Input schema / properties / idQualifiedCapitalGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 10 (Form CG): capital gain net income from qualified Idaho property (real property held 12+ months, etc.) — 60% deductible"
+}Input schema / properties / idQualifyingChildrenAdded value: +{
+ "description": "ID line 24: qualifying children age 16 or under on December 31, 2025 — $205 nonrefundable each (TY2025 only; § 63-3029L sunsets for 2026)",
+ "type": "integer"
+}Input schema / properties / idQualifyingRetirementBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R line 8e: qualifying CSRS/FSRDS, Idaho firefighter, Idaho city police, or U.S. military retirement benefits included in federal income (not FERS, PERSI base plan, or private pensions)"
+}Input schema / properties / idRailroadBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R line 8b: federal Railroad Retirement benefits received (RRB-1099 Box 5, RRB-1099-R Box 7 less Box 8)"
+}Input schema / properties / idRealEstateTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 14 input: Schedule A line 5b real estate taxes"
+}Input schema / properties / idReceivedPublicAssistanceAdded value: +{
+ "description": "ID line 31: receiving Idaho public assistance payments at year end (not food stamps/WIC) — no $10 permanent building fund tax",
+ "type": "boolean"
+}Input schema / properties / idRequiredToFileAdded value: +{
+ "description": "ID line 31: set false when gross income is below the Idaho filing threshold (single $15,750 / $17,750 at 65+; MFJ $31,500; HOH $23,625; MFS $5) — no $10 permanent building fund tax; defaults to true",
+ "type": "boolean"
+}Input schema / properties / idRetirementEligibleAdded value: +{
+ "description": "ID Form 39R line 8: the filer (or spouse) meets the § 63-3022A age/disability test — 65, or 62 and disabled; military retirees: disabled, 62+, or employed with income requiring a federal return. Not available MFS",
+ "type": "boolean"
+}Input schema / properties / idSaltAllowedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 14 input: Schedule A line 5e taxes allowed after the federal cap (used when 5a+5b+5c exceeds $40,000 / $20,000 MFS)"
+}Input schema / properties / idSaltIncomeOrSalesTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 14 input: federal Schedule A line 5a state and local income taxes or general sales taxes"
+}Input schema / properties / idSchAHealthPremiumsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID health/LTC worksheet line 1: health insurance premiums included on federal Schedule A (medical) — only matters when itemizing for Idaho"
+}Input schema / properties / idSchALtcPremiumsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID health/LTC worksheet line 2: long-term care premiums included on federal Schedule A"
+}Input schema / properties / idSchAOtherMedicalAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID health/LTC worksheet line 3: other medical expenses on federal Schedule A"
+}Input schema / properties / idSocialSecurityBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R line 8c: Social Security benefits RECEIVED (SSA-1099 Box 5, gross) — reduces the $48,216 / $72,324 retirement deduction maximum"
+}Input schema / properties / idSpouseEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R child care worksheet line 6: spouse's earned income (MFJ)"
+}Input schema / properties / idSpouseItemizesAdded value: +{
+ "description": "ID married filing separately: the spouse itemizes — the filer MUST itemize (standard deduction $0); pass idFederalItemized and the Schedule A amounts",
+ "type": "boolean"
+}Input schema / properties / idStateRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 2: state income tax refund included in federal income (Schedule 1 line 1)"
+}Input schema / properties / idUsInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part B line 3: interest from U.S. government obligations in federal AGI"
+}Input schema / properties / idUseTaxPurchasesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID line 28: purchases on which no Idaho sales tax was paid (online, mail order, out-of-state) — 6%"
+}Input schema / properties / idYouthContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "ID Form 39R Part D line 2: donations to Idaho youth/rehabilitation facilities, centers for independent living, or licensed substance abuse centers (50% credit, ≤ 20% of tax, ≤ $100 / $200 joint)"
+}Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok",
- "ct",
- "ks",
- "ar",
- "nm",
- "ne"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct",
+ "ks",
+ "ar",
+ "nm",
+ "ne",
+ "id"
+]calculate_tax24 fields changedInput schema / properties / state / properties / neAdjustmentsDecreasingAdded value: +{
+ "description": "Form 1040N line 13: total Schedule I Part B adjustments decreasing federal AGI — part of the Schedule II ratio denominator (us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neAdjustmentsIncreasingAdded value: +{
+ "description": "Form 1040N line 12: total Schedule I Part A adjustments increasing federal AGI — part of the Schedule II ratio denominator (us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neAgeBlindBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040N line 2a boxes checked: you 65 or older, you blind, spouse 65 or older, spouse blind (0-4) — $2,000 each for single/HOH, $1,650 each for MFJ/QSS/MFS; the rule clamps at 2 for single, QSS, and HOH (us.ne.standard_deduction). For MFS the spouse boxes count only if you can claim the spouse's exemption."
+}Input schema / properties / state / properties / neAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form 1040N line 5 (Form 1040 line 11) — the $29,000 child care credit split (us.ne.child_care_credit_nonrefundable, us.ne.child_care_credit_refundable) and the Schedule II ratio denominator (us.ne.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neChildCareExpensesAdded value: +{
+ "description": "Form 2441N line 2(C)/3: qualified child and dependent care expenses paid, before the $3,000 / $6,000 cap (us.ne.child_care_credit_refundable). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neChildCareQualifyingPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 2441N line 2 qualifying persons — caps line 3 at $3,000 for one, $6,000 for two or more (us.ne.child_care_credit_refundable)."
+}Input schema / properties / state / properties / neEarnedIncomeAdded value: +{
+ "description": "Form 2441N line 4: the taxpayer's earned income (us.ne.child_care_credit_refundable). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040N line 4 Nebraska personal exemptions: yourself and spouse (unless claimable as another taxpayer's dependent) plus the dependents who qualify for the federal child tax credit or other dependent credit — $171 each (us.ne.personal_exemption_credit)."
+}Input schema / properties / state / properties / neFederalChildCareCreditAdded value: +{
+ "description": "Federal child and dependent care credit allowed, Schedule 3 line 2 — Nebraska allows 25% when AGI exceeds $29,000 (us.ne.child_care_credit_nonrefundable). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalEicAdded value: +{
+ "description": "Federal earned income credit, Form 1040 line 27a — Nebraska allows 10% (us.ne.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalItemizedDeductionsAdded value: +{
+ "description": "Form 1040N line 7: total federal itemized deductions, Schedule A line 17 (us.ne.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalOtherTaxAdded value: +{
+ "description": "Form 1040N line 16c: federal tax on lump-sum distributions (Form 4972) plus federal tax on early distributions (the lesser of Form 5329 or Schedule 2 line 8) — Nebraska adds 29.6% (us.ne.other_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalStandardDeductionAdded value: +{
+ "description": "The federal standard deduction actually allowed on Form 1040 line 12e — caps the Nebraska standard deduction for a filer who can be claimed as another taxpayer's dependent (us.ne.standard_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalTaxBeforeCreditsAdded value: +{
+ "description": "Federal Tax Liability Worksheet line 3: Form 1040 line 16 + Schedule 2 line 2 + Schedule 2 line 8 — the ceiling on Nebraska tax after nonrefundable credits when net adjustments are under $5,000 (us.ne.tax_after_credits). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neLocalUseTaxRateBpsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040N line 58 local use tax rate in basis points — 0, 50, 100, 150, 175, or 200 (0.5% to 2%) from the local sales and use tax codes schedule (us.ne.use_tax)."
+}Input schema / properties / state / properties / neNetAdjustmentsAdded value: +{
+ "description": "Form 1040N line 12 minus line 13 (net Schedule I adjustments; may be negative) — under $5,000 the § 77-2715(1) federal tax liability cap applies (us.ne.tax_after_credits). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neNonrefundableCreditsAdded value: +{
+ "description": "Form 1040N line 34: total nonrefundable credits, lines 18 through 33 (us.ne.tax_after_credits). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neOtherStateAgiAdded value: +{
+ "description": "Schedule II line 2: adjusted gross income derived from the other state per the DOR Conversion Chart (not that state's taxable income) (us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neOtherStateTaxPaidAdded value: +{
+ "description": "Schedule II line 5: income tax due and paid to the other state or its political subdivision (not the amount withheld; no foreign taxes) (us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neSaltIncomeTaxesAdded value: +{
+ "description": "Form 1040N line 8: state and local INCOME taxes on federal Schedule A line 5a, before the federal cap — $0 if line 5a is general sales taxes (us.ne.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neSpouseEarnedIncomeAdded value: +{
+ "description": "Form 2441N line 5: the spouse's earned income on a joint return (student/disabled deemed amounts per the federal instructions) (us.ne.child_care_credit_refundable). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neTaxBeforeCreditsAdded value: +{
+ "description": "Form 1040N line 17: total Nebraska tax before the personal exemption credit (line 15 + line 16) (us.ne.tax_after_credits, us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neUseTaxPurchasesAdded value: +{
+ "description": "Form 1040N line 58: 2025 taxable purchases on which no Nebraska sales tax was collected (us.ne.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neUseTaxTableAdded value: +{
+ "description": "Compute Nebraska line 15 from the paper 2025 Nebraska Tax Table (row-midpoint cells and the over-$77,760 endpoint worksheet) instead of the Tax Calculation Schedule that e-filers must use (us.ne.income_tax). The two differ by up to $3 (the table prices each $100 row at its midpoint).",
+ "type": "boolean"
+}compute_return24 fields changedInput schema / properties / state / properties / neAdjustmentsDecreasingAdded value: +{
+ "description": "Form 1040N line 13: total Schedule I Part B adjustments decreasing federal AGI — part of the Schedule II ratio denominator (us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neAdjustmentsIncreasingAdded value: +{
+ "description": "Form 1040N line 12: total Schedule I Part A adjustments increasing federal AGI — part of the Schedule II ratio denominator (us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neAgeBlindBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040N line 2a boxes checked: you 65 or older, you blind, spouse 65 or older, spouse blind (0-4) — $2,000 each for single/HOH, $1,650 each for MFJ/QSS/MFS; the rule clamps at 2 for single, QSS, and HOH (us.ne.standard_deduction). For MFS the spouse boxes count only if you can claim the spouse's exemption."
+}Input schema / properties / state / properties / neAgiAdded value: +{
+ "description": "Federal adjusted gross income, Form 1040N line 5 (Form 1040 line 11) — the $29,000 child care credit split (us.ne.child_care_credit_nonrefundable, us.ne.child_care_credit_refundable) and the Schedule II ratio denominator (us.ne.other_state_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neChildCareExpensesAdded value: +{
+ "description": "Form 2441N line 2(C)/3: qualified child and dependent care expenses paid, before the $3,000 / $6,000 cap (us.ne.child_care_credit_refundable). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neChildCareQualifyingPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 2441N line 2 qualifying persons — caps line 3 at $3,000 for one, $6,000 for two or more (us.ne.child_care_credit_refundable)."
+}Input schema / properties / state / properties / neEarnedIncomeAdded value: +{
+ "description": "Form 2441N line 4: the taxpayer's earned income (us.ne.child_care_credit_refundable). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040N line 4 Nebraska personal exemptions: yourself and spouse (unless claimable as another taxpayer's dependent) plus the dependents who qualify for the federal child tax credit or other dependent credit — $171 each (us.ne.personal_exemption_credit)."
+}Input schema / properties / state / properties / neFederalChildCareCreditAdded value: +{
+ "description": "Federal child and dependent care credit allowed, Schedule 3 line 2 — Nebraska allows 25% when AGI exceeds $29,000 (us.ne.child_care_credit_nonrefundable). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalEicAdded value: +{
+ "description": "Federal earned income credit, Form 1040 line 27a — Nebraska allows 10% (us.ne.eitc). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalItemizedDeductionsAdded value: +{
+ "description": "Form 1040N line 7: total federal itemized deductions, Schedule A line 17 (us.ne.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalOtherTaxAdded value: +{
+ "description": "Form 1040N line 16c: federal tax on lump-sum distributions (Form 4972) plus federal tax on early distributions (the lesser of Form 5329 or Schedule 2 line 8) — Nebraska adds 29.6% (us.ne.other_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalStandardDeductionAdded value: +{
+ "description": "The federal standard deduction actually allowed on Form 1040 line 12e — caps the Nebraska standard deduction for a filer who can be claimed as another taxpayer's dependent (us.ne.standard_deduction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neFederalTaxBeforeCreditsAdded value: +{
+ "description": "Federal Tax Liability Worksheet line 3: Form 1040 line 16 + Schedule 2 line 2 + Schedule 2 line 8 — the ceiling on Nebraska tax after nonrefundable credits when net adjustments are under $5,000 (us.ne.tax_after_credits). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neLocalUseTaxRateBpsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Form 1040N line 58 local use tax rate in basis points — 0, 50, 100, 150, 175, or 200 (0.5% to 2%) from the local sales and use tax codes schedule (us.ne.use_tax)."
+}Input schema / properties / state / properties / neNetAdjustmentsAdded value: +{
+ "description": "Form 1040N line 12 minus line 13 (net Schedule I adjustments; may be negative) — under $5,000 the § 77-2715(1) federal tax liability cap applies (us.ne.tax_after_credits). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neNonrefundableCreditsAdded value: +{
+ "description": "Form 1040N line 34: total nonrefundable credits, lines 18 through 33 (us.ne.tax_after_credits). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neOtherStateAgiAdded value: +{
+ "description": "Schedule II line 2: adjusted gross income derived from the other state per the DOR Conversion Chart (not that state's taxable income) (us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neOtherStateTaxPaidAdded value: +{
+ "description": "Schedule II line 5: income tax due and paid to the other state or its political subdivision (not the amount withheld; no foreign taxes) (us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neSaltIncomeTaxesAdded value: +{
+ "description": "Form 1040N line 8: state and local INCOME taxes on federal Schedule A line 5a, before the federal cap — $0 if line 5a is general sales taxes (us.ne.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neSpouseEarnedIncomeAdded value: +{
+ "description": "Form 2441N line 5: the spouse's earned income on a joint return (student/disabled deemed amounts per the federal instructions) (us.ne.child_care_credit_refundable). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neTaxBeforeCreditsAdded value: +{
+ "description": "Form 1040N line 17: total Nebraska tax before the personal exemption credit (line 15 + line 16) (us.ne.tax_after_credits, us.ne.other_state_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neUseTaxPurchasesAdded value: +{
+ "description": "Form 1040N line 58: 2025 taxable purchases on which no Nebraska sales tax was collected (us.ne.use_tax). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / neUseTaxTableAdded value: +{
+ "description": "Compute Nebraska line 15 from the paper 2025 Nebraska Tax Table (row-midpoint cells and the over-$77,760 endpoint worksheet) instead of the Tax Calculation Schedule that e-filers must use (us.ne.income_tax). The two differ by up to $3 (the table prices each $100 row at its midpoint).",
+ "type": "boolean"
+}compute_state_return37 fields changedInput schema / properties / ageOrBlindBoxes / descriptionPrevious value: -"count of age-65+/blind boxes checked (taxpayer/spouse, per box)"New value: +"count of age-65+/blind boxes checked (taxpayer/spouse, per box); NE line 2a: +$2,000 single/HOH or +$1,650 married/QSS each"Input schema / properties / dependents / descriptionPrevious value: -"dependent count (CA dependent exemption credits; NY $1,000 exemptions; KS $2,320 exemptions; AR $29 personal credits and the Low Income Tax Table column; NM line 5 exemptions and the $4,000 dependents deduction)"New value: +"dependent count (CA dependent exemption credits; NY $1,000 exemptions; KS $2,320 exemptions; AR $29 personal credits and the Low Income Tax Table column; NM line 5 exemptions and the $4,000 dependents deduction; NE $171 exemption credits — count only federal CTC/ODC dependents)"Input schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm/ne — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok",
- "ct",
- "ks",
- "ar",
- "nm"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct",
+ "ks",
+ "ar",
+ "nm",
+ "ne"
+]Input schema / properties / neAmendedOverpaymentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 54 (amended return only): overpayment allowed on the original return"
+}Input schema / properties / neAmendedPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 52 (amended return only): amount paid with the original return plus later payments"
+}Input schema / properties / neChildCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Form 2441N line 3 base (AGI $29,000 or less): qualified child/dependent care expenses paid, capped at $3,000 / $6,000 by neChildCareQualifyingPersons"
+}Input schema / properties / neChildCareQualifyingPersonsAdded value: +{
+ "description": "NE Form 2441N qualifying persons (1 → $3,000 cap; 2 or more → $6,000); defaults to 1",
+ "type": "integer"
+}Input schema / properties / neCommunityCollegeTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 45 (Form PTC line 2a → line 1): community college property taxes paid in 2025 on parcels you own — 100% refundable credit (the school district credit ended with LB 34; use the DOR Look-up Tool)"
+}Input schema / properties / neCreditForwardAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 61: overpayment applied to 2026 estimated tax"
+}Input schema / properties / neEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Form 2441N line 4: the taxpayer's earned income"
+}Input schema / properties / neFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 23: the federal child and dependent care credit (Schedule 3 line 2) — 25% nonrefundable when AGI is over $29,000"
+}Input schema / properties / neFederalElderlyCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 20: the federal credit for the elderly or the disabled (Schedule R, Schedule 3 line 6d) — Nebraska allows the same amount, nonrefundable"
+}Input schema / properties / neFederalItemizedAdded value: +{
+ "description": "NE lines 7-10: the filer itemized on the federal return — Nebraska then allows the LARGER of its standard deduction and federal itemized deductions minus state and local income taxes (pass neFederalItemizedDeductions and neSaltIncomeTaxes). A federal standard-deduction filer must use the Nebraska standard deduction",
+ "type": "boolean"
+}Input schema / properties / neFederalItemizedDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 7: federal Schedule A line 17 total itemized deductions"
+}Input schema / properties / neFederalOtherTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 16c: federal Form 4972 lump-sum tax plus federal Form 5329 early-distribution tax (the lesser of Form 5329 or Schedule 2 line 8) — Nebraska adds 29.6%"
+}Input schema / properties / neFederalStandardDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 6, REQUIRED when claimedAsDependent or neSpouseClaimedAsDependent (line 2b): the federal standard deduction actually allowed (Form 1040 line 12e) — the Nebraska deduction is the smaller of it and the chart amount"
+}Input schema / properties / neFederalTaxBeforeCreditsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 35 Federal Tax Liability Worksheet line 3: Form 1040 line 16 + Schedule 2 line 2 + Schedule 2 line 8 — when net Schedule I adjustments (line 12 − 13) are under $5,000, Nebraska tax after nonrefundable credits cannot exceed this (§ 77-2715(1)). Omitted, the cap is skipped with a note"
+}Input schema / properties / neK1nWithholdingAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 38: Nebraska income tax withheld reported on Schedules K-1N"
+}Input schema / properties / neLocalUseTaxRateAdded value: +{
+ "description": "NE line 58: your local sales and use tax rate in percent from the codes schedule (0.5, 1, 1.5, 1.75, or 2); omit for none",
+ "type": "number"
+}Input schema / properties / neMilitaryRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Schedule I line 32: military retirement benefits in federal AGI (Form 1040 line 5b, DoD or OPM 1099-R) — 100% excluded"
+}Input schema / properties / neNestContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Schedule I line 20: contributions by the account owner to Nebraska Educational Savings Plan Trust (NEST / Bloomwell / State Farm 529) accounts — the composer caps at $10,000 ($5,000 MFS)"
+}Input schema / properties / neOtherStateAgiAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Schedule II line 2: adjusted gross income derived from another state per the DOR Conversion Chart (not that state's taxable income)"
+}Input schema / properties / neOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Schedule II line 5: income tax due and paid to the other state (or its political subdivision) — not withholding; no foreign taxes; attach the other state's complete return"
+}Input schema / properties / nePtetCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 39: pass-through entity tax (PTET) credit from Schedules K-1N"
+}Input schema / properties / neSaltIncomeTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 8: state and local INCOME taxes on federal Schedule A line 5a (before the federal cap); $0 if line 5a is general sales taxes"
+}Input schema / properties / neSpouseClaimedAsDependentAdded value: +{
+ "description": "NE line 4b: the spouse can be claimed as another taxpayer's dependent — no exemption for the spouse",
+ "type": "boolean"
+}Input schema / properties / neSpouseEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Form 2441N line 5: the spouse's earned income (MFJ)"
+}Input schema / properties / neStateRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Schedule I line 14: state income tax refund included in federal AGI (Schedule 1 line 1)"
+}Input schema / properties / neStillbornChildrenAdded value: +{
+ "description": "NE line 47: stillborn children (20+ weeks, Nebraska certificate attached) — $2,000 each, refundable",
+ "type": "integer"
+}Input schema / properties / neUnderpaymentPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 56: Form 2210N penalty for underpayment of estimated tax"
+}Input schema / properties / neUsInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE Schedule I lines 15-17: interest and RIC dividends from U.S. government obligations exempt from state tax"
+}Input schema / properties / neUseTaxPurchasesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 58: 2025 taxable purchases on which no Nebraska sales tax was collected (Internet / out-of-state) — 5.5% state plus the local rate"
+}Input schema / properties / neUseTaxTableAdded value: +{
+ "description": "NE line 15: compute from the paper Nebraska Tax Table (row midpoints, endpoint worksheet over $77,760) instead of the Tax Calculation Schedule e-filers must use — they differ by up to $3 (the table prices each $100 row at its midpoint)",
+ "type": "boolean"
+}Input schema / properties / neVolunteerRespondersAdded value: +{
+ "description": "NE line 46: qualified volunteer emergency responders on the return certified to DOR for at least two years (0-2) — $250 each, refundable",
+ "type": "integer"
+}Input schema / properties / neWildlifeDonationAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 62: Wildlife Conservation Fund donation from the overpayment ($1 or more)"
+}Input schema / properties / neWithholding1099Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NE line 37: Nebraska income tax withheld on W-2G, 1099-R, 1099-MISC, 1099-NEC (W-2 withholding goes in stateWithholding → line 36)"
+}calculate_tax26 fields changedInput schema / properties / filing / properties / useFormulaMethod / descriptionPrevious value: -"Compute with exact continuous formulas instead of the printed-form methods (analysis/comparison mode — filed returns use the forms). Affects: the IRS Tax Table below $100,000, the § 32(f) EIC Table ($50-bracket midpoints), and Schedule SE's per-line whole-dollar rounding."New value: +"Compute with exact continuous formulas instead of the printed-form methods (analysis/comparison mode — filed returns use the forms). Affects: the IRS Tax Table below $100,000, the § 32(f) EIC Table ($50-bracket midpoints), Schedule SE's per-line whole-dollar rounding, and the state packs that print a table or worksheet (KS us.ks.income_tax, NM us.nm.income_tax — exact § 7-2-7 schedule instead of the midpoint table and the printed over-$100,000 worksheet)."Input schema / properties / state / properties / nmAge65CountAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Taxpayer and spouse who are 65 or older — gates the $3,000 medical care expense exemption, the $2,800 refundable medical care credit, and the property tax rebate for persons 65 or older (us.nm.medical_expense_exemption_65, us.nm.medical_care_credit_65, us.nm.property_tax_rebate_65)."
+}Input schema / properties / state / properties / nmAge65OrBlindPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Taxpayer and spouse who are 65 or older OR blind (PIT-1 boxes 1c/1d/2c/2d) — one exemption per person, never two for the same person (us.nm.age65_blind_exemption); at most 1 unless married filing jointly."
+}Input schema / properties / state / properties / nmAgiAdded value: +{
+ "description": "Federal adjusted gross income, PIT-1 line 9 (Form 1040 line 11) — the base of the low- and middle-income exemption (us.nm.low_middle_income_exemption), the 65-or-older/blind exemption table (us.nm.age65_blind_exemption), the Social Security exemption cliff (us.nm.social_security_exemption), and the child income tax credit tiers (us.nm.child_income_tax_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmArmedForcesRetirementPayAdded value: +{
+ "description": "The primary taxpayer's armed forces retirement pay (or survivor pay of an armed forces retiree) included in federal AGI — $30,000 exempt (us.nm.armed_forces_retirement_exemption). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmArmedForcesRetirementPaySpouseAdded value: +{
+ "description": "The spouse's armed forces retirement pay on a joint return — its own $30,000 exemption (us.nm.armed_forces_retirement_exemption). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmBusinessSaleGainAdded value: +{
+ "description": "Net capital gain from the sale of a business allocated or apportioned to New Mexico under § 7-2-11 (us.nm.capital_gains_deduction: 40% of up to $1,000,000). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependents and other dependents on PIT-1 line 8 / Schedule PIT-S (federal § 152) — $4,000 for each beyond the first for a head of household or MFJ filer (us.nm.dependents_deduction)."
+}Input schema / properties / state / properties / nmExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "PIT-1 line 5 exemptions: yourself (unless you can be claimed as a dependent) + spouse on a joint return + dependents and other dependents reported on the federal return — each worth up to $2,500 (us.nm.low_middle_income_exemption)."
+}Input schema / properties / state / properties / nmFederalEicAdded value: +{
+ "description": "Federal earned income credit (Form 1040 line 27), or the EIC computed under the NM Expansion for a filer denied federally only by the SSN or under-25 age rule — New Mexico allows 25% (us.nm.working_families_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmFederalItemizedAdded value: +{
+ "description": "The filer itemized deductions on the 2025 federal return (PIT-1 box 12a) — the state and local tax add-back applies only then (us.nm.salt_addback).",
+ "type": "boolean"
+}Input schema / properties / state / properties / nmFederalItemizedDeductionsAdded value: +{
+ "description": "Total federal itemized deductions actually claimed on Form 1040 line 12 — worksheet line 8 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmFederalStandardDeductionAdded value: +{
+ "description": "The federal standard deduction the filer could have claimed on Form 1040 line 12 had they not itemized — worksheet line 7 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmMedicalExpensesAdded value: +{
+ "description": "Unreimbursed and uncompensated medical care expenses paid in the year for the taxpayer, spouse, or dependents (§ 7-2-5.9 definition; includes Medicare Part B premiums) — $28,000 or more with a taxpayer 65+ unlocks the $3,000 exemption and the $2,800 credit (us.nm.medical_expense_exemption_65, us.nm.medical_care_credit_65). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmModifiedGrossIncomeAdded value: +{
+ "description": "PIT-RC line 12 modified gross income (§ 7-2-2(L)): ALL income of the taxpayer, spouse, and dependents, taxable or not, undiminished by losses — wages, gross Social Security and pensions, unemployment, public assistance, business profit (no losses), gross capital gains, gifts, interest, child support (us.nm.lictr, us.nm.property_tax_rebate_65, us.nm.county_property_tax_rebate). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmNetCapitalGainAdded value: +{
+ "description": "Net capital gain per IRC § 1222(11) — the excess of net long-term capital gain over net short-term capital loss (us.nm.capital_gains_deduction: up to $2,500). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmPropertyTaxBilledAdded value: +{
+ "description": "Property tax billed for the calendar year on the principal place of residence (dwelling plus up to five acres) (us.nm.property_tax_rebate_65 line 15, us.nm.county_property_tax_rebate line 18a). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Qualifying children under IRC § 152(c) (plus public-assistance-supported minor children) — one child income tax credit each (us.nm.child_income_tax_credit)."
+}Input schema / properties / state / properties / nmRebateCountyAdded value: +{
+ "description": "The taxpayer OWNS and occupies a principal residence in Los Alamos, Santa Fe, Doña Ana, or Bernalillo County — enables the additional low income property tax rebate (us.nm.county_property_tax_rebate).",
+ "type": "boolean"
+}Input schema / properties / state / properties / nmRebateExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "PIT-RC line 13a rebate exemptions: PIT-1 line 5 exemptions minus non-qualifying household members, plus 1 for each blind person and 2 for each person 65 or older (§ 7-2-14(C)) — selects the LICTR column (us.nm.lictr)."
+}Input schema / properties / state / properties / nmRentPaidAdded value: +{
+ "description": "Rent paid during the year on the principal place of residence, including government subsidies paid to the landlord — 6% counts as property tax (us.nm.property_tax_rebate_65 lines 16a-16c). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmSaltAllowedAdded value: +{
+ "description": "Federal Schedule A line 5e: state and local taxes actually deducted after the cap — worksheet line 4 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmSaltIncomeTaxesAdded value: +{
+ "description": "Federal Schedule A line 5a: state and local INCOME taxes (or general sales taxes) claimed — PIT-1 line 10 worksheet line 1 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmSaltTotalAdded value: +{
+ "description": "Federal Schedule A line 5d: total state and local taxes before the SALT cap — worksheet line 2 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmTaxableSocialSecurityAdded value: +{
+ "description": "Federally taxable Social Security benefits (Form 1040 line 6b) — exempt in full when AGI is not over the § 7-2-5.14 limit (us.nm.social_security_exemption). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / stateTaxableIncome / descriptionPrevious value: -"STATE taxable income (e.g. CA Form 540 line 19, VA Form 760 line 15, IL net income line 11) — computed by the preparer under state law, then fed to the state tax targets (us.ca.income_tax, us.va.income_tax, us.il.income_tax) so the rate-schedule arithmetic is engine-pinned instead of recalled. In dollars."New value: +"STATE taxable income (e.g. CA Form 540 line 19, VA Form 760 line 15, IL net income line 11) — computed by the preparer under state law, then fed to the state tax targets (us.ca.income_tax, us.va.income_tax, us.il.income_tax) so the rate-schedule arithmetic is engine-pinned instead of recalled. In dollars. NM: PIT-1 line 17 (us.nm.income_tax)."compute_return26 fields changedInput schema / properties / filing / properties / useFormulaMethod / descriptionPrevious value: -"Compute with exact continuous formulas instead of the printed-form methods (analysis/comparison mode — filed returns use the forms). Affects: the IRS Tax Table below $100,000, the § 32(f) EIC Table ($50-bracket midpoints), and Schedule SE's per-line whole-dollar rounding."New value: +"Compute with exact continuous formulas instead of the printed-form methods (analysis/comparison mode — filed returns use the forms). Affects: the IRS Tax Table below $100,000, the § 32(f) EIC Table ($50-bracket midpoints), Schedule SE's per-line whole-dollar rounding, and the state packs that print a table or worksheet (KS us.ks.income_tax, NM us.nm.income_tax — exact § 7-2-7 schedule instead of the midpoint table and the printed over-$100,000 worksheet)."Input schema / properties / state / properties / nmAge65CountAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Taxpayer and spouse who are 65 or older — gates the $3,000 medical care expense exemption, the $2,800 refundable medical care credit, and the property tax rebate for persons 65 or older (us.nm.medical_expense_exemption_65, us.nm.medical_care_credit_65, us.nm.property_tax_rebate_65)."
+}Input schema / properties / state / properties / nmAge65OrBlindPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Taxpayer and spouse who are 65 or older OR blind (PIT-1 boxes 1c/1d/2c/2d) — one exemption per person, never two for the same person (us.nm.age65_blind_exemption); at most 1 unless married filing jointly."
+}Input schema / properties / state / properties / nmAgiAdded value: +{
+ "description": "Federal adjusted gross income, PIT-1 line 9 (Form 1040 line 11) — the base of the low- and middle-income exemption (us.nm.low_middle_income_exemption), the 65-or-older/blind exemption table (us.nm.age65_blind_exemption), the Social Security exemption cliff (us.nm.social_security_exemption), and the child income tax credit tiers (us.nm.child_income_tax_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmArmedForcesRetirementPayAdded value: +{
+ "description": "The primary taxpayer's armed forces retirement pay (or survivor pay of an armed forces retiree) included in federal AGI — $30,000 exempt (us.nm.armed_forces_retirement_exemption). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmArmedForcesRetirementPaySpouseAdded value: +{
+ "description": "The spouse's armed forces retirement pay on a joint return — its own $30,000 exemption (us.nm.armed_forces_retirement_exemption). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmBusinessSaleGainAdded value: +{
+ "description": "Net capital gain from the sale of a business allocated or apportioned to New Mexico under § 7-2-11 (us.nm.capital_gains_deduction: 40% of up to $1,000,000). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependents and other dependents on PIT-1 line 8 / Schedule PIT-S (federal § 152) — $4,000 for each beyond the first for a head of household or MFJ filer (us.nm.dependents_deduction)."
+}Input schema / properties / state / properties / nmExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "PIT-1 line 5 exemptions: yourself (unless you can be claimed as a dependent) + spouse on a joint return + dependents and other dependents reported on the federal return — each worth up to $2,500 (us.nm.low_middle_income_exemption)."
+}Input schema / properties / state / properties / nmFederalEicAdded value: +{
+ "description": "Federal earned income credit (Form 1040 line 27), or the EIC computed under the NM Expansion for a filer denied federally only by the SSN or under-25 age rule — New Mexico allows 25% (us.nm.working_families_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmFederalItemizedAdded value: +{
+ "description": "The filer itemized deductions on the 2025 federal return (PIT-1 box 12a) — the state and local tax add-back applies only then (us.nm.salt_addback).",
+ "type": "boolean"
+}Input schema / properties / state / properties / nmFederalItemizedDeductionsAdded value: +{
+ "description": "Total federal itemized deductions actually claimed on Form 1040 line 12 — worksheet line 8 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmFederalStandardDeductionAdded value: +{
+ "description": "The federal standard deduction the filer could have claimed on Form 1040 line 12 had they not itemized — worksheet line 7 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmMedicalExpensesAdded value: +{
+ "description": "Unreimbursed and uncompensated medical care expenses paid in the year for the taxpayer, spouse, or dependents (§ 7-2-5.9 definition; includes Medicare Part B premiums) — $28,000 or more with a taxpayer 65+ unlocks the $3,000 exemption and the $2,800 credit (us.nm.medical_expense_exemption_65, us.nm.medical_care_credit_65). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmModifiedGrossIncomeAdded value: +{
+ "description": "PIT-RC line 12 modified gross income (§ 7-2-2(L)): ALL income of the taxpayer, spouse, and dependents, taxable or not, undiminished by losses — wages, gross Social Security and pensions, unemployment, public assistance, business profit (no losses), gross capital gains, gifts, interest, child support (us.nm.lictr, us.nm.property_tax_rebate_65, us.nm.county_property_tax_rebate). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmNetCapitalGainAdded value: +{
+ "description": "Net capital gain per IRC § 1222(11) — the excess of net long-term capital gain over net short-term capital loss (us.nm.capital_gains_deduction: up to $2,500). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmPropertyTaxBilledAdded value: +{
+ "description": "Property tax billed for the calendar year on the principal place of residence (dwelling plus up to five acres) (us.nm.property_tax_rebate_65 line 15, us.nm.county_property_tax_rebate line 18a). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Qualifying children under IRC § 152(c) (plus public-assistance-supported minor children) — one child income tax credit each (us.nm.child_income_tax_credit)."
+}Input schema / properties / state / properties / nmRebateCountyAdded value: +{
+ "description": "The taxpayer OWNS and occupies a principal residence in Los Alamos, Santa Fe, Doña Ana, or Bernalillo County — enables the additional low income property tax rebate (us.nm.county_property_tax_rebate).",
+ "type": "boolean"
+}Input schema / properties / state / properties / nmRebateExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "PIT-RC line 13a rebate exemptions: PIT-1 line 5 exemptions minus non-qualifying household members, plus 1 for each blind person and 2 for each person 65 or older (§ 7-2-14(C)) — selects the LICTR column (us.nm.lictr)."
+}Input schema / properties / state / properties / nmRentPaidAdded value: +{
+ "description": "Rent paid during the year on the principal place of residence, including government subsidies paid to the landlord — 6% counts as property tax (us.nm.property_tax_rebate_65 lines 16a-16c). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmSaltAllowedAdded value: +{
+ "description": "Federal Schedule A line 5e: state and local taxes actually deducted after the cap — worksheet line 4 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmSaltIncomeTaxesAdded value: +{
+ "description": "Federal Schedule A line 5a: state and local INCOME taxes (or general sales taxes) claimed — PIT-1 line 10 worksheet line 1 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmSaltTotalAdded value: +{
+ "description": "Federal Schedule A line 5d: total state and local taxes before the SALT cap — worksheet line 2 (us.nm.salt_addback). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / nmTaxableSocialSecurityAdded value: +{
+ "description": "Federally taxable Social Security benefits (Form 1040 line 6b) — exempt in full when AGI is not over the § 7-2-5.14 limit (us.nm.social_security_exemption). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / stateTaxableIncome / descriptionPrevious value: -"STATE taxable income (e.g. CA Form 540 line 19, VA Form 760 line 15, IL net income line 11) — computed by the preparer under state law, then fed to the state tax targets (us.ca.income_tax, us.va.income_tax, us.il.income_tax) so the rate-schedule arithmetic is engine-pinned instead of recalled. In dollars."New value: +"STATE taxable income (e.g. CA Form 540 line 19, VA Form 760 line 15, IL net income line 11) — computed by the preparer under state law, then fed to the state tax targets (us.ca.income_tax, us.va.income_tax, us.il.income_tax) so the rate-schedule arithmetic is engine-pinned instead of recalled. In dollars. NM: PIT-1 line 17 (us.nm.income_tax)."compute_state_return39 fields changedInput schema / properties / dependents / descriptionPrevious value: -"dependent count (CA dependent exemption credits; NY $1,000 exemptions; KS $2,320 exemptions; AR $29 personal credits and the Low Income Tax Table column)"New value: +"dependent count (CA dependent exemption credits; NY $1,000 exemptions; KS $2,320 exemptions; AR $29 personal credits and the Low Income Tax Table column; NM line 5 exemptions and the $4,000 dependents deduction)"Input schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks/nm — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok",
- "ct",
- "ks",
- "ar"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct",
+ "ks",
+ "ar",
+ "nm"
+]Input schema / properties / nmAge65CountAdded value: +{
+ "description": "NM: taxpayer and spouse who are 65 or older (0-2) — gates the $3,000 medical exemption, the $2,800 medical credit, the 65+ property tax rebate, and adds 2 LICTR exemptions each",
+ "type": "integer"
+}Input schema / properties / nmAge65OrBlindPersonsAdded value: +{
+ "description": "NM PIT-ADJ line 13: taxpayer and spouse who are 65 or older OR blind (0-2; one per person even if both) — up to $8,000 each by AGI",
+ "type": "integer"
+}Input schema / properties / nmArmedForcesRetirementPayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-ADJ line 24: the primary's armed forces retirement pay (or survivor benefit) in federal AGI — $30,000 exempt"
+}Input schema / properties / nmArmedForcesRetirementPaySpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-ADJ line 24: the spouse's armed forces retirement pay (MFJ) — its own $30,000"
+}Input schema / properties / nmBlindCountAdded value: +{
+ "description": "NM: taxpayer and spouse who are blind for federal purposes (0-2) — adds 1 LICTR rebate exemption each (PIT-RC line 2c)",
+ "type": "integer"
+}Input schema / properties / nmBusinessSaleGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-ADJ line 16: net capital gain from the sale of a New Mexico-apportioned business — 40% of up to $1,000,000 deducted if larger"
+}Input schema / properties / nmChildDayCareWorksheetAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-RC line 19 base: the sum of column G on the Child Day Care Credit Worksheet (40% of caregiver pay at up to $8 per day, up to $480 per child) — the composer caps at $1,200, subtracts the federal child care credit, and applies the $30,160 MGI limit"
+}Input schema / properties / nmContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 40: PIT-D voluntary contributions from the overpayment"
+}Input schema / properties / nmCreditForwardAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 41: overpayment applied to 2026 estimated tax"
+}Input schema / properties / nmExpansionEicAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 25a (NM Expansion, box 25b): the federal EIC the filer WOULD have received but for the SSN or under-25 age rule — used when federalEITC is 0"
+}Input schema / properties / nmFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-RC line 21: the federal child and dependent care credit applied on Schedule 3 line 2 — subtracted from the New Mexico day care credit"
+}Input schema / properties / nmFederalDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 12: the federal standard or itemized deduction from Form 1040 line 12 — REQUIRED (New Mexico taxable income subtracts the federal deduction; § 7-2-2(N))"
+}Input schema / properties / nmFederalItemizedAdded value: +{
+ "description": "NM PIT-1 box 12a: the filer itemized on the federal return — triggers the line 10 state and local tax add-back (pass nmSaltIncomeTaxes / nmSaltTotal / nmSaltAllowed / nmFederalStandardDeduction)",
+ "type": "boolean"
+}Input schema / properties / nmFederalStandardDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM line 10 worksheet line 7: the federal standard deduction the itemizer could have claimed instead"
+}Input schema / properties / nmIncomeTaxedByBothStatesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM line 20 worksheet line 4: the income subject to tax in BOTH states (capped at each state's taxable income)"
+}Input schema / properties / nmInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 37: interest at the IRC rate, daily, from the original due date"
+}Input schema / properties / nmLatePenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 36: late filing/payment penalty — 2% of the unpaid line 33 tax per month or part, maximum 20%"
+}Input schema / properties / nmLumpSumAmountAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 19: the lump-sum distribution amount taxed under the federal 10-year option (Form 4972) — New Mexico adds 5 × the tax on 20% of it"
+}Input schema / properties / nmMedicalExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM: unreimbursed medical care expenses paid (§ 7-2-5.9 definition) — $28,000 or more with a 65+ taxpayer gives the PIT-ADJ line 18 $3,000 exemption and the PIT-RC line 23 $2,800 refundable credit"
+}Input schema / properties / nmModifiedGrossIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-RC line 12 modified gross income: ALL income of the taxpayer, spouse, and dependents, taxable or not, undiminished by losses (wages, gross Social Security and pensions, unemployment, public assistance, business profit, gross capital gains, gifts, interest, child support). REQUIRED for the LICTR, property tax rebates, and child day care credit — omitted, those sections are skipped with a note"
+}Input schema / properties / nmNetCapitalGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-ADJ line 16: net capital gain (§ 1222(11), net long-term gain over net short-term loss) — up to $2,500 deducted"
+}Input schema / properties / nmNonQualifyingHouseholdMembersAdded value: +{
+ "description": "NM PIT-RC line 2a: household members who do not qualify for the LICTR (nonresident dependents; a spouse not present six months)",
+ "type": "integer"
+}Input schema / properties / nmOilGasWithholdingAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 28: New Mexico tax withheld from oil and gas proceeds (1099-MISC / RPD-41285)"
+}Input schema / properties / nmOtherStateTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 20 worksheet (column 2 line 1): income tax due to the other state (not withholding; not a city or county tax)"
+}Input schema / properties / nmOtherStateTaxableIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM line 20 worksheet (column 2 line 2): the other state's taxable income on which that tax was computed"
+}Input schema / properties / nmPropertyTaxBilledAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-RC lines 15 / 18a: property tax billed for 2025 on the owned principal residence"
+}Input schema / properties / nmPteWithholdingAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 29: New Mexico tax withheld by or paid as entity-level/composite tax by pass-through entities (RPD-41359)"
+}Input schema / properties / nmQualifyingChildrenAdded value: +{
+ "description": "NM PIT-RC line 25: qualifying children (§ 152(c)) — child income tax credit $637 to $26 each by AGI, refundable",
+ "type": "integer"
+}Input schema / properties / nmRebateCountyAdded value: +{
+ "description": "NM PIT-RC Section 4: the owner-occupied principal residence is in Los Alamos, Santa Fe, Doña Ana, or Bernalillo County — additional low income property tax rebate (MGI ≤ $24,000)",
+ "type": "boolean"
+}Input schema / properties / nmRentPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-RC line 16a: rent paid in 2025 on the principal residence (6% counts as property tax for the 65+ rebate)"
+}Input schema / properties / nmSaltAllowedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM line 10 worksheet line 4: federal Schedule A line 5e (state and local taxes deducted after the cap)"
+}Input schema / properties / nmSaltIncomeTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM line 10 worksheet line 1: federal Schedule A line 5a (state and local income taxes, or sales taxes, claimed)"
+}Input schema / properties / nmSaltTotalAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM line 10 worksheet line 2: federal Schedule A line 5d (total state and local taxes before the cap)"
+}Input schema / properties / nmSpecialNeedsAdoptedChildrenAdded value: +{
+ "description": "NM PIT-RC line 24: certified special needs adopted children claimed as dependents — $1,500 each ($750 MFS), refundable",
+ "type": "integer"
+}Input schema / properties / nmSpouseRebateExemptionsClaimedAdded value: +{
+ "description": "NM PIT-RC line 2h (married filing separately only): the household members and extra exemptions your spouse already claimed on the spouse's PIT-RC line 2g — subtracted so each exemption is claimed once",
+ "type": "integer"
+}Input schema / properties / nmUnderpaymentPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "NM PIT-1 line 34: penalty on underpayment of estimated tax (RPD-41272 / PIT-ES instructions)"
+}calculate_tax21 fields changedInput schema / properties / state / properties / arAgiAdded value: +{
+ "description": "Arkansas adjusted gross income (AR1000F line 25) of the return or COLUMN being evaluated — the Low Income Tax Table lookup base (us.ar.low_income_tax), the standard-deduction cap (us.ar.standard_deduction), and, as the COMBINED line 25A + 25B, the 10% medical and 2% miscellaneous floors (us.ar.itemized_deductions). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arCasualtyLossesAdded value: +{
+ "description": "AR3 line 18: total casualty and theft losses from AR4684 (after the $100 exclusion and the 10%-of-AGI test) (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arChildCareExpensesAdded value: +{
+ "description": "AR2441 line 2(c)/3: qualified child and dependent care expenses paid in the year, before the $3,000 / $6,000 cap (us.ar.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arChildCareQualifyingPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of qualifying persons on AR2441 line 2 — caps line 3 at $3,000 for one, $6,000 for two or more (us.ar.child_care_credit)."
+}Input schema / properties / state / properties / arContributionsAdded value: +{
+ "description": "AR3 lines 13-16: cash, art/literary, other, and carryover contributions (excess over 60% of AGI carries forward five years) (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arCreditBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of AR1000F line 7A boxes checked for '65 or over', '65 Special' (65+ and NOT claiming the line 18 retirement exclusion), 'Blind', and 'Deaf' — taxpayer and spouse (at most 4 each; the rule clamps an unmarried filer at 4). $29 each (us.ar.personal_tax_credits). Do NOT count Yourself, Spouse, or the head-of-household/surviving-spouse box — the rule adds those from filingStatus."
+}Input schema / properties / state / properties / arDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependents listed on AR1000F line 7B — $29 each (us.ar.personal_tax_credits) and the '1 or no' vs '2 or more' Low Income Tax Table column (us.ar.low_income_tax)."
+}Input schema / properties / state / properties / arEarnedIncomeAdded value: +{
+ "description": "AR2441 line 4: the taxpayer's earned income (us.ar.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arFederalAgiAdded value: +{
+ "description": "AR2441 line 7 = federal Form 1040 line 11 — sets the 35%-to-20% percentage (1 point per $2,000 over $15,000) (us.ar.child_care_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arInterestPaidAdded value: +{
+ "description": "AR3 lines 8-11: home mortgage interest (institutions and individuals), deductible points, and investment interest limited to investment income (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arLongTermGainAdded value: +{
+ "description": "AR1000D line 3: Arkansas net long-term capital gain or LOSS (negative) for the column — federal Schedule D line 15 adjusted for depreciation differences (us.ar.capital_gains). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arMedicalExpensesAdded value: +{
+ "description": "AR3 line 1: medical and dental expenses paid, not reimbursed — the rule subtracts 10% of Arkansas AGI (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arMilitaryRetirementAdded value: +{
+ "description": "The same taxpayer's exempt military retirement pay (AR1000F line 17) — reduces the $6,000 pension/IRA exclusion dollar for dollar (Ark. Code § 26-51-307(f); us.ar.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arMiscExpensesAdded value: +{
+ "description": "AR3 lines 20-21: unreimbursed employee business expenses (AR2106) and other miscellaneous deductions SUBJECT to the 2%-of-AGI floor — the rule subtracts 2% of Arkansas AGI (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arOtherMiscDeductionsAdded value: +{
+ "description": "AR3 lines 26-28: volunteer firefighter expenses (≤ $1,000), gambling losses (≤ winnings), and other miscellaneous deductions NOT subject to the 2% floor (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arPensionTaxableAdded value: +{
+ "description": "ONE taxpayer's federally taxable employer-plan pension and qualified traditional IRA distributions (1099-R box 2a; IRA only after 59½ or on death/disability) — the base of the $6,000 exclusion (us.ar.retirement_exclusion). Premature IRA withdrawals and annuities go on line 16 with no exclusion. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arShortTermGainAdded value: +{
+ "description": "AR1000D lines 6/11: Arkansas net short-term capital gain (positive) or loss (negative) for the column — federal Schedule D line 7 (us.ar.capital_gains). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arSpouseEarnedIncomeAdded value: +{
+ "description": "AR2441 line 5: the spouse's earned income when filingStatus is mfj (Arkansas status 2 or 4; a student or disabled spouse's deemed income per the instructions); ignored for other statuses (us.ar.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arStatus4Added value: +{
+ "description": "Arkansas Filing Status 4 — a married couple (filingStatus mfj) filing SEPARATELY ON THE SAME RETURN, each spouse taxed on their own column; false = status 2 (joint). Affects us.ar.standard_deduction ($2,470 per column instead of $4,940), us.ar.additional_tax_credit (per column, not doubled), us.ar.capital_gains ($1,500 loss limit per column), and us.ar.low_income_tax (refused for status 4).",
+ "type": "boolean"
+}Input schema / properties / state / properties / arTaxesPaidAdded value: +{
+ "description": "AR3 lines 5-6: real estate tax plus personal property tax and other deductible taxes (city income taxes, foreign income taxes on income taxed here) — NOT Arkansas or federal income taxes or sales taxes (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arTuitionDeductionAdded value: +{
+ "description": "AR3 line 19: post-secondary education tuition deduction(s) from AR1075 (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return21 fields changedInput schema / properties / state / properties / arAgiAdded value: +{
+ "description": "Arkansas adjusted gross income (AR1000F line 25) of the return or COLUMN being evaluated — the Low Income Tax Table lookup base (us.ar.low_income_tax), the standard-deduction cap (us.ar.standard_deduction), and, as the COMBINED line 25A + 25B, the 10% medical and 2% miscellaneous floors (us.ar.itemized_deductions). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arCasualtyLossesAdded value: +{
+ "description": "AR3 line 18: total casualty and theft losses from AR4684 (after the $100 exclusion and the 10%-of-AGI test) (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arChildCareExpensesAdded value: +{
+ "description": "AR2441 line 2(c)/3: qualified child and dependent care expenses paid in the year, before the $3,000 / $6,000 cap (us.ar.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arChildCareQualifyingPersonsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of qualifying persons on AR2441 line 2 — caps line 3 at $3,000 for one, $6,000 for two or more (us.ar.child_care_credit)."
+}Input schema / properties / state / properties / arContributionsAdded value: +{
+ "description": "AR3 lines 13-16: cash, art/literary, other, and carryover contributions (excess over 60% of AGI carries forward five years) (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arCreditBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of AR1000F line 7A boxes checked for '65 or over', '65 Special' (65+ and NOT claiming the line 18 retirement exclusion), 'Blind', and 'Deaf' — taxpayer and spouse (at most 4 each; the rule clamps an unmarried filer at 4). $29 each (us.ar.personal_tax_credits). Do NOT count Yourself, Spouse, or the head-of-household/surviving-spouse box — the rule adds those from filingStatus."
+}Input schema / properties / state / properties / arDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependents listed on AR1000F line 7B — $29 each (us.ar.personal_tax_credits) and the '1 or no' vs '2 or more' Low Income Tax Table column (us.ar.low_income_tax)."
+}Input schema / properties / state / properties / arEarnedIncomeAdded value: +{
+ "description": "AR2441 line 4: the taxpayer's earned income (us.ar.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arFederalAgiAdded value: +{
+ "description": "AR2441 line 7 = federal Form 1040 line 11 — sets the 35%-to-20% percentage (1 point per $2,000 over $15,000) (us.ar.child_care_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arInterestPaidAdded value: +{
+ "description": "AR3 lines 8-11: home mortgage interest (institutions and individuals), deductible points, and investment interest limited to investment income (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arLongTermGainAdded value: +{
+ "description": "AR1000D line 3: Arkansas net long-term capital gain or LOSS (negative) for the column — federal Schedule D line 15 adjusted for depreciation differences (us.ar.capital_gains). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arMedicalExpensesAdded value: +{
+ "description": "AR3 line 1: medical and dental expenses paid, not reimbursed — the rule subtracts 10% of Arkansas AGI (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arMilitaryRetirementAdded value: +{
+ "description": "The same taxpayer's exempt military retirement pay (AR1000F line 17) — reduces the $6,000 pension/IRA exclusion dollar for dollar (Ark. Code § 26-51-307(f); us.ar.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arMiscExpensesAdded value: +{
+ "description": "AR3 lines 20-21: unreimbursed employee business expenses (AR2106) and other miscellaneous deductions SUBJECT to the 2%-of-AGI floor — the rule subtracts 2% of Arkansas AGI (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arOtherMiscDeductionsAdded value: +{
+ "description": "AR3 lines 26-28: volunteer firefighter expenses (≤ $1,000), gambling losses (≤ winnings), and other miscellaneous deductions NOT subject to the 2% floor (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arPensionTaxableAdded value: +{
+ "description": "ONE taxpayer's federally taxable employer-plan pension and qualified traditional IRA distributions (1099-R box 2a; IRA only after 59½ or on death/disability) — the base of the $6,000 exclusion (us.ar.retirement_exclusion). Premature IRA withdrawals and annuities go on line 16 with no exclusion. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arShortTermGainAdded value: +{
+ "description": "AR1000D lines 6/11: Arkansas net short-term capital gain (positive) or loss (negative) for the column — federal Schedule D line 7 (us.ar.capital_gains). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arSpouseEarnedIncomeAdded value: +{
+ "description": "AR2441 line 5: the spouse's earned income when filingStatus is mfj (Arkansas status 2 or 4; a student or disabled spouse's deemed income per the instructions); ignored for other statuses (us.ar.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arStatus4Added value: +{
+ "description": "Arkansas Filing Status 4 — a married couple (filingStatus mfj) filing SEPARATELY ON THE SAME RETURN, each spouse taxed on their own column; false = status 2 (joint). Affects us.ar.standard_deduction ($2,470 per column instead of $4,940), us.ar.additional_tax_credit (per column, not doubled), us.ar.capital_gains ($1,500 loss limit per column), and us.ar.low_income_tax (refused for status 4).",
+ "type": "boolean"
+}Input schema / properties / state / properties / arTaxesPaidAdded value: +{
+ "description": "AR3 lines 5-6: real estate tax plus personal property tax and other deductible taxes (city income taxes, foreign income taxes on income taxed here) — NOT Arkansas or federal income taxes or sales taxes (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / arTuitionDeductionAdded value: +{
+ "description": "AR3 line 19: post-secondary education tuition deduction(s) from AR1075 (us.ar.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return56 fields changedInput schema / properties / arAdjustmentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 24: TOTAL adjustments from AR1000ADJ (IRA payments, HSA/MSA, student loan interest ≤ $2,500 with the $85,000-$100,000 / $170,000-$200,000 phase-out, tuition savings ≤ $5,000 per taxpayer, intergenerational trust ≤ $4,000, moving expenses, self-employed health insurance, Keogh/SEP/SIMPLE, early-withdrawal penalty, alimony paid, disabled-individual support $500, organ donor ≤ $10,000, reserve expenses, reforestation, teacher classroom expense, ABLE ≤ $5,000) — transcribed"
+}Input schema / properties / arAge65CountAdded value: +{
+ "description": "AR: number of taxpayers on the return who are 65 or over (0-2) — lets the composer add the '65 Special' $29 box when the Low Income Tax Table path forgoes the line 18 retirement exclusion (on the regular path count 65 Special yourself in arCreditBoxes)",
+ "type": "integer"
+}Input schema / properties / arAlimonyReceivedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 12: alimony and separate maintenance received under a court order"
+}Input schema / properties / arAmendedPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 42 (amended return only): previous payments with the original return and billing notices"
+}Input schema / properties / arAmendedRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 45 (amended return only): previous refund(s) from the original and earlier amended returns (subtracted)"
+}Input schema / properties / arBusinessIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 13: net business or professional income (federal Schedule C), may be negative"
+}Input schema / properties / arCasualtyLossesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR3 line 18: casualty and theft losses from AR4684 (after the $100 exclusion and 10%-of-AGI test)"
+}Input schema / properties / arCheckoffsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 49: AR1000CO check-off contributions (Disaster Relief, Game and Fish, Schools for the Blind/Deaf, Baby Sharon's, Organ Donor, Area Agencies on Aging, Military Family Relief, Cord Blood, Law Enforcement Family Relief, Brighter Future 529) — whole dollars, from the overpayment"
+}Input schema / properties / arChildCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR2441 line 3 base: qualified child and dependent care expenses paid (capped at $3,000 / $6,000 by arChildCareQualifyingPersons); the credit is 20% of the 2013-law federal computation — requires federalAGI (AR2441 line 7)"
+}Input schema / properties / arChildCareQualifyingPersonsAdded value: +{
+ "description": "AR2441 line 2: number of qualifying persons (1 → $3,000 cap; 2 or more → $6,000); defaults to 1",
+ "type": "integer"
+}Input schema / properties / arConsideredUnmarriedAdded value: +{
+ "description": "AR2441 status 5 only: the filer meets the 'considered unmarried' tests (lived apart the last 6 months, kept up the qualifying person's home) — otherwise a status 5 filer cannot claim the child care credit",
+ "type": "boolean"
+}Input schema / properties / arContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR3 lines 13-16: cash, art/literary, other, and carryover contributions"
+}Input schema / properties / arCreditBoxesAdded value: +{
+ "description": "AR line 7A: count of '65 or over', '65 Special' (65+ and NOT claiming the line 18 retirement exclusion), 'Blind', and 'Deaf' boxes for the taxpayer and spouse (0-8) — $29 each; the Yourself/Spouse/head-of-household boxes are added automatically",
+ "type": "integer"
+}Input schema / properties / arCreditForwardAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 48: overpayment to apply to 2026 estimated tax (credited to the primary filer only)"
+}Input schema / properties / arDevelopmentallyDisabledDependentsAdded value: +{
+ "description": "AR1000TC line 7: dependents with a certified developmental disability (AR1000-DD on file) — $500 each",
+ "type": "integer"
+}Input schema / properties / arDividendsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 11: dividend income (no dividend exclusion)"
+}Input schema / properties / arEarlyChildhoodApprovedAdded value: +{
+ "description": "AR line 43: the qualifying child attends an APPROVED early childhood program (Form AR1000EC certificate) — the 20% AR2441 credit becomes REFUNDABLE on line 43 instead of nonrefundable on line 35",
+ "type": "boolean"
+}Input schema / properties / arEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR2441 line 4: the taxpayer's earned income"
+}Input schema / properties / arExemptIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR Low Income Tax Table test only: income NOT on lines 8-22 (Social Security, VA benefits, workers' compensation, Railroad Retirement, U.S./Arkansas obligation interest, the $250,000/$500,000 residence gain) — qualification 1 counts 'total income from all sources (regardless of whether the income is taxable to Arkansas)'; the exempt half of long-term capital gains and the forgone retirement/military exclusions are added automatically"
+}Input schema / properties / arFarmIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 20: farm income (federal Schedule F), may be negative"
+}Input schema / properties / arFederalEarlyWithdrawalTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 32 base: the FEDERAL Form 5329 Part I additional tax on early IRA/qualified plan distributions (plus Part II Coverdell) — Arkansas adds 10% of it"
+}Input schema / properties / arInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 10: interest income (AR4 if over $1,500; U.S. and Arkansas obligation interest is exempt — exclude it)"
+}Input schema / properties / arInterestPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR3 lines 8-11: home mortgage interest, deductible points, investment interest (≤ investment income)"
+}Input schema / properties / arIraTaxableAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 16: taxable NON-qualified IRA distributions (premature withdrawals), lump sums, and annuities — no $6,000 exclusion; pass the federal Form 5329 tax in arFederalEarlyWithdrawalTax"
+}Input schema / properties / arItemizeAdded value: +{
+ "description": "AR line 26/27: force AR3 itemized deductions (true) or the standard deduction (false). Omit to take the LARGER (independent of the federal election; married spouses must match under § 26-51-430(a)(2))",
+ "type": "boolean"
+}Input schema / properties / arLongTermGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 14 via AR1000D: net LONG-TERM capital gain or loss (federal Schedule D line 15, adjusted for Arkansas depreciation) — 50% of a net long-term gain is exempt; gain over $10,000,000 exempt"
+}Input schema / properties / arLumpSumTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 31: tax from the Lump Sum Distribution Averaging Schedule AR1000TD (transcribed)"
+}Input schema / properties / arMedicalExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR3 line 1: medical and dental expenses paid — the 10%-of-AGI floor is applied by the rule"
+}Input schema / properties / arMilitaryPayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 9: U.S. active-duty military compensation, household total (100% exempt; informational box; the W-2 wages must be excluded from `wages`). Under the Low Income Tax Table election it is counted as income in the primary's column"
+}Input schema / properties / arMilitaryRetirementPrimaryAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 17: the primary's military retirement (100% exempt; informational box) — reduces the primary's $6,000 pension exclusion dollar for dollar"
+}Input schema / properties / arMilitaryRetirementSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 17: the spouse's military retirement (exempt) — reduces the spouse's $6,000 exclusion"
+}Input schema / properties / arMiscExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR3 lines 20-21: unreimbursed employee business expenses (AR2106), union dues, tax preparation fees, and other deductions SUBJECT to the 2%-of-AGI floor (applied by the rule)"
+}Input schema / properties / arOtherGainsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 15: other gains or losses (federal Form 4797 Part II; no capital loss limit)"
+}Input schema / properties / arOtherIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 22: net other income and depreciation differences from Form AR-OI (gambling winnings, cancellation of debt, taxable scholarships/stipends, HSA/MSA taxable distributions, PET back-outs, NOL carryforward as a negative, federal-vs-Arkansas depreciation), may be negative"
+}Input schema / properties / arOtherMiscDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR3 lines 26-28: volunteer firefighter expenses (≤ $1,000), gambling losses (≤ winnings), other deductions not subject to the 2% floor"
+}Input schema / properties / arOtherStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR1000TC line 2: the other state's income included on this return — the composer approximates the three-step method by recomputing the line 29 tax with this removed from line 28 (or line 25 on the low-income table); status 4 takes it from the primary's column"
+}Input schema / properties / arOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR1000TC line 2: income tax actually paid to another state on income also taxed by Arkansas (attach that state's signed return) — credit is the LESSER of this or the Arkansas tax on that income"
+}Input schema / properties / arPensionTaxablePrimaryAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 18A: the primary's TAXABLE employer-plan pension and qualified traditional IRA distributions (1099-R box 2a; IRA after 59½ or on death/disability) — the composer applies the $6,000 exclusion"
+}Input schema / properties / arPensionTaxableSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 18B: the spouse's taxable employer pension / qualified IRA (status 2 or 4 only) — its own $6,000 exclusion"
+}Input schema / properties / arPoliticalContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR1000TC line 1: cash contributions to Arkansas state/local candidates, approved PACs, or parties (by April 15, 2026) — credit capped at $50 per taxpayer ($100 status 2/4)"
+}Input schema / properties / arRentsRoyaltiesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 19: rents, royalties, partnerships, estates, trusts (federal Schedule E), may be negative"
+}Input schema / properties / arShortTermGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 14 via AR1000D: net SHORT-TERM capital gain (100% taxed) or loss (federal Schedule D line 7); the net loss is limited to $3,000 ($1,500 per taxpayer for status 4/5). For a status-4 comparison this is the PRIMARY's own column — the spouse's gains go in arSpouseLongTermGain / arSpouseShortTermGain"
+}Input schema / properties / arSpouseAdjustmentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR status 4 column B: the spouse's share of the AR1000ADJ adjustments (line 24B); column A gets arAdjustments minus this"
+}Input schema / properties / arSpouseEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR2441 line 5: the spouse's earned income (status 2 or 4; student/disabled deemed amounts per the instructions)"
+}Input schema / properties / arSpouseIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR status 4 column B: the SPOUSE's share of lines 8-22 (wages, interest, dividends, business, capital gains, rents, other) — the primary's column A is the household total minus this; line 18B (spouse pension) is added automatically. Business/farm income cannot be split without a partnership"
+}Input schema / properties / arSpouseLongTermGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR status 4 column B (AR1000D): the SPOUSE's net long-term capital gain or loss — its own 50% exclusion and $1,500 loss floor; added to the primary's for a status 2 (joint) return"
+}Input schema / properties / arSpouseShortTermGainAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR status 4 column B (AR1000D): the spouse's net short-term capital gain or loss"
+}Input schema / properties / arStatus4Added value: +{
+ "description": "AR: elect Filing Status 4 — married filing separately on the SAME return (each spouse's own column, $2,470 deduction each, one rate table). Omit with arSpouseIncome given to let the composer take the LOWER of status 2 (joint) and status 4; false forces joint",
+ "type": "boolean"
+}Input schema / properties / arTaxesPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR3 lines 5-6: real estate tax plus personal property and other deductible taxes (city income, foreign income taxes) — NEVER Arkansas/federal income tax or sales tax"
+}Input schema / properties / arTuitionDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR3 line 19: post-secondary education tuition deduction from AR1075"
+}Input schema / properties / arUnderestimatePenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 52B: underestimate penalty from AR2210 line 17 or AR2210A line 48 (required when line 51 is over $1,000 unless an exception applies)"
+}Input schema / properties / arUseLowIncomeTableAdded value: +{
+ "description": "AR line 26: force the Low Income Tax Table (true; statuses 1, 2, 3, 6 within the income limits, no itemizing — the retirement/military exclusions are then NOT used) or the Regular Income Tax Table (false). Omit to let the composer take the LOWER net tax",
+ "type": "boolean"
+}Input schema / properties / arWithholding1099Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "AR line 39B: Arkansas tax withheld on 1099-R, 1099-PT, and AR-K1 forms (new separate line for 2025; W-2 withholding goes in stateWithholding → line 39A)"
+}Input schema / properties / dependents / descriptionPrevious value: -"dependent count (CA dependent exemption credits; NY $1,000 exemptions; KS $2,320 exemptions)"New value: +"dependent count (CA dependent exemption credits; NY $1,000 exemptions; KS $2,320 exemptions; AR $29 personal credits and the Low Income Tax Table column)"Input schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks — the composer refuses without it (AR needs it only for the AR2441 child care credit). NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok",
- "ct",
- "ks"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct",
+ "ks",
+ "ar"
+]calculate_tax12 fields changedInput schema / properties / state / properties / ksCharitableContributionsAdded value: +{
+ "description": "Gifts to charity by cash, other than cash, and carryover (Kansas Schedule A lines 10-12, § 170 limits) — 100% deductible (us.ks.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksChildrenBornThisYearAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependent children born during the tax year — an ADDITIONAL $2,320 Kansas exemption each (K.S.A. 79-32,121; us.ks.exemptions)."
+}Input schema / properties / state / properties / ksDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of dependents claimed on the federal return — $2,320 each on Form K-40 (us.ks.exemptions); zero when the filer is claimed as someone else's dependent (isClaimedAsDependent)."
+}Input schema / properties / state / properties / ksDisabledVeteransAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Honorably discharged veterans on the return (taxpayer and/or spouse) certified by the VA at the 100% permanent disability rate — an additional $2,320 Kansas exemption each for 2025 and later (us.ks.exemptions)."
+}Input schema / properties / state / properties / ksFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income (Kansas Schedule A line 2 = Form 1040 line 11) — the base of the 7.5% medical floor (us.ks.itemized_deductions). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksFederalChildCareCreditAdded value: +{
+ "description": "Federal child and dependent care credit ALLOWED (Form 2441 / Schedule 3 line 2) — Kansas allows 50%, nonrefundable, residents only (us.ks.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksFederalEicAdded value: +{
+ "description": "Federal earned income credit (Form 1040 line 27a) — Kansas allows 17%, nonrefundable to the line 16 tax with the excess refundable (us.ks.eitc); residents only, valid SSNs required. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksMedicalExpensesAdded value: +{
+ "description": "Medical and dental expenses paid (Kansas Schedule A line 1; the federal Schedule A line 1 amount, or the total if the filer did not itemize federally) — Kansas allows 100% of § 213 expenses over 7.5% of federal AGI (us.ks.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksMortgageInterestAdded value: +{
+ "description": "Qualified residence interest and points (Kansas Schedule A lines 8a-8c, § 163(h)) — 100% deductible (us.ks.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksPropertyTaxesAdded value: +{
+ "description": "State and local REAL ESTATE plus value-based PERSONAL PROPERTY taxes paid (Kansas Schedule A lines 5-6) — 100% deductible with no SALT cap; state/local income or sales taxes are NOT deductible in Kansas (us.ks.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksStdBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Kansas standard-deduction boxes for 65-or-older and/or blind (taxpayer and spouse: at most 2 for single/HOH/QSS, 4 for MFJ/MFS — the rule clamps a single/HOH count at 2) — each adds $850 (single/HOH/QSS) or $700 (MFJ/MFS) to the base deduction (us.ks.standard_deduction)."
+}Input schema / properties / state / properties / ksStillbirthsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Stillbirths during the tax year for which a certificate of stillbirth was issued — $2,320 Kansas exemption each (us.ks.exemptions)."
+}compute_return12 fields changedInput schema / properties / state / properties / ksCharitableContributionsAdded value: +{
+ "description": "Gifts to charity by cash, other than cash, and carryover (Kansas Schedule A lines 10-12, § 170 limits) — 100% deductible (us.ks.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksChildrenBornThisYearAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependent children born during the tax year — an ADDITIONAL $2,320 Kansas exemption each (K.S.A. 79-32,121; us.ks.exemptions)."
+}Input schema / properties / state / properties / ksDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of dependents claimed on the federal return — $2,320 each on Form K-40 (us.ks.exemptions); zero when the filer is claimed as someone else's dependent (isClaimedAsDependent)."
+}Input schema / properties / state / properties / ksDisabledVeteransAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Honorably discharged veterans on the return (taxpayer and/or spouse) certified by the VA at the 100% permanent disability rate — an additional $2,320 Kansas exemption each for 2025 and later (us.ks.exemptions)."
+}Input schema / properties / state / properties / ksFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income (Kansas Schedule A line 2 = Form 1040 line 11) — the base of the 7.5% medical floor (us.ks.itemized_deductions). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksFederalChildCareCreditAdded value: +{
+ "description": "Federal child and dependent care credit ALLOWED (Form 2441 / Schedule 3 line 2) — Kansas allows 50%, nonrefundable, residents only (us.ks.child_care_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksFederalEicAdded value: +{
+ "description": "Federal earned income credit (Form 1040 line 27a) — Kansas allows 17%, nonrefundable to the line 16 tax with the excess refundable (us.ks.eitc); residents only, valid SSNs required. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksMedicalExpensesAdded value: +{
+ "description": "Medical and dental expenses paid (Kansas Schedule A line 1; the federal Schedule A line 1 amount, or the total if the filer did not itemize federally) — Kansas allows 100% of § 213 expenses over 7.5% of federal AGI (us.ks.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksMortgageInterestAdded value: +{
+ "description": "Qualified residence interest and points (Kansas Schedule A lines 8a-8c, § 163(h)) — 100% deductible (us.ks.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksPropertyTaxesAdded value: +{
+ "description": "State and local REAL ESTATE plus value-based PERSONAL PROPERTY taxes paid (Kansas Schedule A lines 5-6) — 100% deductible with no SALT cap; state/local income or sales taxes are NOT deductible in Kansas (us.ks.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ksStdBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Kansas standard-deduction boxes for 65-or-older and/or blind (taxpayer and spouse: at most 2 for single/HOH/QSS, 4 for MFJ/MFS — the rule clamps a single/HOH count at 2) — each adds $850 (single/HOH/QSS) or $700 (MFJ/MFS) to the base deduction (us.ks.standard_deduction)."
+}Input schema / properties / state / properties / ksStillbirthsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Stillbirths during the tax year for which a certificate of stillbirth was issued — $2,320 Kansas exemption each (us.ks.exemptions)."
+}compute_state_return29 fields changedInput schema / properties / dependents / descriptionPrevious value: -"dependent count (CA dependent exemption credits; NY $1,000 exemptions)"New value: +"dependent count (CA dependent exemption credits; NY $1,000 exemptions; KS $2,320 exemptions)"Input schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct/ks — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok",
- "ct"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct",
+ "ks"
+]Input schema / properties / ks529BeneficiariesAdded value: +{
+ "description": "number of 529 beneficiaries contributed for (caps line A16 at $3,000/$6,000 each); defaults to 1 when contributions are given",
+ "type": "integer"
+}Input schema / properties / ks529ContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS Schedule S line A16: contributions to Learning Quest / Quest529 / Schwab 529 or another state's 529 plan — the composer caps at $3,000 per beneficiary ($6,000 MFJ) using ks529Beneficiaries"
+}Input schema / properties / ksAmendedOverpaymentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 26 (amended return only): overpayment shown on the original return (subtracted)"
+}Input schema / properties / ksAmendedPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 24 (amended return only): payments remitted with the original return"
+}Input schema / properties / ksCharitableContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS Schedule A line 13: gifts to charity by cash, other than cash, and carryover (100%, § 170 limits)"
+}Input schema / properties / ksCheckoffsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS lines 35-42 total: voluntary contributions (Chickadee, Meals on Wheels, breast cancer research, military emergency relief, hometown heroes, creative arts, school district, historic site) — reduce the refund or increase the amount owed"
+}Input schema / properties / ksChildrenBornThisYearAdded value: +{
+ "description": "dependent children born during the tax year — additional $2,320 exemption each",
+ "type": "integer"
+}Input schema / properties / ksCreditForwardAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 34: overpayment applied to 2026 estimated tax ($1 or more)"
+}Input schema / properties / ksDisabledVeteransAdded value: +{
+ "description": "taxpayer and/or spouse honorably discharged and VA-certified 100% permanently disabled — additional $2,320 exemption each",
+ "type": "integer"
+}Input schema / properties / ksEstimatedTaxPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 31: underpayment of estimated tax penalty from Schedule K-210 (applies when line 18 less withholding and refundable credits is $500 or more)"
+}Input schema / properties / ksExemptRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS Schedule S line A14: retirement benefits exempt from Kansas tax included in federal AGI — KPERS, Kansas Police & Fire, Kansas teachers' annuities, federal civil service and MILITARY retirement (incl. TSP), Railroad Retirement, Highway Patrol, judges, Board of Public Utilities, Regents annuity contracts, Washburn, Overland Park police/fire (NOT Social Security — automatic via taxableSocialSecurity)"
+}Input schema / properties / ksFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal child and dependent care credit ALLOWED (Form 2441 / Schedule 3 line 2) — Kansas allows 50% on line 14, nonrefundable, residents only"
+}Input schema / properties / ksFederalLumpSumTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 11: the FEDERAL tax on a lump-sum distribution from Form 4972 — Kansas tax is 13% of it (residents; KPERS lump sums prorated by the agent)"
+}Input schema / properties / ksInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 29: interest on a late-paid balance — 0.6667% per month (8% per annum) from the due date (agent-computed)"
+}Input schema / properties / ksItemizeAdded value: +{
+ "description": "force the deduction method: true = Kansas itemized (Schedule A), false = standard. Omit to let the composer take the LARGER (Kansas allows either regardless of the federal election; married-filing-separately spouses must use the same method — disclose)",
+ "type": "boolean"
+}Input schema / properties / ksK120sCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 25: credit for the 5.58% tax paid on the filer's behalf by electing pass-through entities (Form K-9 Part C)"
+}Input schema / properties / ksMedicalExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS Schedule A line 1: medical and dental expenses paid (federal Schedule A line 1, or the total if not itemizing federally) — the composer applies the 7.5%-of-federal-AGI floor"
+}Input schema / properties / ksMortgageInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS Schedule A line 9: qualified residence interest and points (100%)"
+}Input schema / properties / ksOtherStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 13 worksheet line 3: total income from the other state included in Kansas AGI — the credit is limited to Kansas tax × (this ÷ KAGI)"
+}Input schema / properties / ksOtherStateTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 13 worksheet line 1: 2025 income tax actually paid to ONE other state (incl. its localities) — not the amount withheld; enclose that state's return"
+}Input schema / properties / ksPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS line 30: late payment penalty — 1% per month or fraction, maximum 24% (none when 90% was paid by the due date under an extension)"
+}Input schema / properties / ksPropertyTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS Schedule A lines 5-6: state and local real estate taxes plus value-based personal property taxes (100%, no SALT cap; NO income or sales taxes)"
+}Input schema / properties / ksStateRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS Schedule S line A13: state or local income tax refund included in federal AGI (Schedule 1 line 1)"
+}Input schema / properties / ksStdBoxesAdded value: +{
+ "description": "Kansas standard-deduction boxes checked for 65-or-older and/or blind (taxpayer + spouse, 0-4): +$850 each single/HOH/QSS, +$700 each MFJ/MFS",
+ "type": "integer"
+}Input schema / properties / ksStillbirthsAdded value: +{
+ "description": "certified stillbirths during the tax year — $2,320 exemption each",
+ "type": "integer"
+}Input schema / properties / ksUsInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "KS Schedule S line A12: interest/dividends on U.S. government obligations included in federal AGI, net of related expenses (not FNMA/GNMA/FHLMC)"
+}calculate_tax13 fields changedInput schema / properties / state / properties / ctAgiAdded value: +{
+ "description": "Connecticut adjusted gross income (Form CT-1040 line 5 = federal AGI + Schedule 1 additions − subtractions) — the single key to the whole Tax Calculation Schedule: Table A exemption, Table B rates, the Table C 2% add-back, Table D recapture, and the Table E credit percentage (us.ct.income_tax, us.ct.personal_exemption), and to the property tax credit phase-out (us.ct.property_tax_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctEitcJointFagiAdded value: +{
+ "description": "The joint federal AGI (Form 1040 line 11; Schedule CT-EITC line 13) when the Connecticut return is married filing separately but the federal return was joint — the proration denominator (us.ct.eitc). 0 = no proration. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctEitcQualifyingChildAdded value: +{
+ "description": "Filer listed at least one qualifying child on federal Schedule EIC (Schedule CT-EITC lines 4-5) — adds the flat $250 (PA 25-168 § 371, TY2025+) to the Connecticut EITC (us.ct.eitc).",
+ "type": "boolean"
+}Input schema / properties / state / properties / ctEitcSeparateFagiAdded value: +{
+ "description": "For a joint FEDERAL filer who must file married-filing-separately for Connecticut: this spouse's separate federal AGI (Schedule CT-EITC line 12) — the 40% credit is multiplied by separate ÷ joint federal AGI to four decimals, not more than 1.0000 (us.ct.eitc). Leave 0 (with ctEitcJointFagi 0) when no proration applies. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income (Form CT-1040 line 1 = federal Form 1040 line 11a, as the 2025 CT form prints it) — keys the Social Security adjustment thresholds ($75,000 single/MFS; $100,000 MFJ/QSS/HOH) and the pension/annuity/IRA phase-out (us.ct.social_security_adjustment, us.ct.pension_annuity_subtraction). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctFederalEicAdded value: +{
+ "description": "Federal earned income credit claimed and allowed (Form 1040 line 27a; Schedule CT-EITC line 8) — us.ct.eitc pays 40% of it plus $250 with a qualifying child. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctIraDistributionsAdded value: +{
+ "description": "Taxable IRA distributions other than Roth (Form 1040 line 4b) — 75% enters the Pension and Annuity Worksheet line 2 for TY2025, 100% for TY2026 (us.ct.pension_annuity_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctPensionAnnuityIncomeAdded value: +{
+ "description": "Taxable pensions and annuities (Form 1040 line 5b) MINUS military retirement pay, Tier 1/Tier 2 Railroad Retirement, and Connecticut Teachers' Retirement income (each subtracted on its own Schedule 1 line) — the 100% component of the Pension and Annuity Worksheet line 2 (us.ct.pension_annuity_subtraction). Exclude disability pensions before minimum retirement age and corrective distributions. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctPropertyTaxPaidAdded value: +{
+ "description": "Qualifying Connecticut property tax paid during the year on the primary residence and eligible motor vehicle(s) (Schedule 3 line 63: one vehicle for single/MFS/HOH, two for MFJ/QSS; bills due and paid in the year; no late payments, interest, or fees) — us.ct.property_tax_credit caps it at $300 and phases it out by Connecticut AGI. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctSsProvisionalExcessAdded value: +{
+ "description": "Federal Social Security Benefits Worksheet line 9 — the excess of provisional income over the § 86(c) base amount ($25,000 / $32,000) — or line 7 for a married-filing-separately filer who lived with the spouse (line B of the Connecticut worksheet; us.ct.social_security_adjustment). May be zero or negative (then no adjustment). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctSsTotalBenefitsAdded value: +{
+ "description": "Total Social Security benefits received (federal Social Security Benefits Worksheet line 1 = Form SSA-1099 box 5 total) — line A of the Connecticut Social Security Benefit Adjustment Worksheet (us.ct.social_security_adjustment). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctTaxableSsAdded value: +{
+ "description": "Federally taxable Social Security benefits (Form 1040 line 6b; federal worksheet line 18) — line E of the Connecticut worksheet; fully subtracted below the AGI threshold (us.ct.social_security_adjustment). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctUseTaxTableAdded value: +{
+ "description": "Use the DRS printed tax tables' method (Connecticut AGI at or under $102,000: the schedule evaluated at the $50 row midpoint, rounded once) instead of the Tax Calculation Schedule with its line-level whole-dollar rounding — Form CT-1040 line 6 allows either (us.ct.income_tax). Above $102,000 the schedule is used regardless.",
+ "type": "boolean"
+}compute_return13 fields changedInput schema / properties / state / properties / ctAgiAdded value: +{
+ "description": "Connecticut adjusted gross income (Form CT-1040 line 5 = federal AGI + Schedule 1 additions − subtractions) — the single key to the whole Tax Calculation Schedule: Table A exemption, Table B rates, the Table C 2% add-back, Table D recapture, and the Table E credit percentage (us.ct.income_tax, us.ct.personal_exemption), and to the property tax credit phase-out (us.ct.property_tax_credit). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctEitcJointFagiAdded value: +{
+ "description": "The joint federal AGI (Form 1040 line 11; Schedule CT-EITC line 13) when the Connecticut return is married filing separately but the federal return was joint — the proration denominator (us.ct.eitc). 0 = no proration. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctEitcQualifyingChildAdded value: +{
+ "description": "Filer listed at least one qualifying child on federal Schedule EIC (Schedule CT-EITC lines 4-5) — adds the flat $250 (PA 25-168 § 371, TY2025+) to the Connecticut EITC (us.ct.eitc).",
+ "type": "boolean"
+}Input schema / properties / state / properties / ctEitcSeparateFagiAdded value: +{
+ "description": "For a joint FEDERAL filer who must file married-filing-separately for Connecticut: this spouse's separate federal AGI (Schedule CT-EITC line 12) — the 40% credit is multiplied by separate ÷ joint federal AGI to four decimals, not more than 1.0000 (us.ct.eitc). Leave 0 (with ctEitcJointFagi 0) when no proration applies. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income (Form CT-1040 line 1 = federal Form 1040 line 11a, as the 2025 CT form prints it) — keys the Social Security adjustment thresholds ($75,000 single/MFS; $100,000 MFJ/QSS/HOH) and the pension/annuity/IRA phase-out (us.ct.social_security_adjustment, us.ct.pension_annuity_subtraction). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctFederalEicAdded value: +{
+ "description": "Federal earned income credit claimed and allowed (Form 1040 line 27a; Schedule CT-EITC line 8) — us.ct.eitc pays 40% of it plus $250 with a qualifying child. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctIraDistributionsAdded value: +{
+ "description": "Taxable IRA distributions other than Roth (Form 1040 line 4b) — 75% enters the Pension and Annuity Worksheet line 2 for TY2025, 100% for TY2026 (us.ct.pension_annuity_subtraction). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctPensionAnnuityIncomeAdded value: +{
+ "description": "Taxable pensions and annuities (Form 1040 line 5b) MINUS military retirement pay, Tier 1/Tier 2 Railroad Retirement, and Connecticut Teachers' Retirement income (each subtracted on its own Schedule 1 line) — the 100% component of the Pension and Annuity Worksheet line 2 (us.ct.pension_annuity_subtraction). Exclude disability pensions before minimum retirement age and corrective distributions. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctPropertyTaxPaidAdded value: +{
+ "description": "Qualifying Connecticut property tax paid during the year on the primary residence and eligible motor vehicle(s) (Schedule 3 line 63: one vehicle for single/MFS/HOH, two for MFJ/QSS; bills due and paid in the year; no late payments, interest, or fees) — us.ct.property_tax_credit caps it at $300 and phases it out by Connecticut AGI. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctSsProvisionalExcessAdded value: +{
+ "description": "Federal Social Security Benefits Worksheet line 9 — the excess of provisional income over the § 86(c) base amount ($25,000 / $32,000) — or line 7 for a married-filing-separately filer who lived with the spouse (line B of the Connecticut worksheet; us.ct.social_security_adjustment). May be zero or negative (then no adjustment). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctSsTotalBenefitsAdded value: +{
+ "description": "Total Social Security benefits received (federal Social Security Benefits Worksheet line 1 = Form SSA-1099 box 5 total) — line A of the Connecticut Social Security Benefit Adjustment Worksheet (us.ct.social_security_adjustment). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctTaxableSsAdded value: +{
+ "description": "Federally taxable Social Security benefits (Form 1040 line 6b; federal worksheet line 18) — line E of the Connecticut worksheet; fully subtracted below the AGI threshold (us.ct.social_security_adjustment). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / ctUseTaxTableAdded value: +{
+ "description": "Use the DRS printed tax tables' method (Connecticut AGI at or under $102,000: the schedule evaluated at the $50 row midpoint, rounded once) instead of the Tax Calculation Schedule with its line-level whole-dollar rounding — Form CT-1040 line 6 allows either (us.ct.income_tax). Above $102,000 the schedule is used regardless.",
+ "type": "boolean"
+}compute_state_return29 fields changedInput schema / properties / ctAbleContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 1 line 48d: contributions to ABLE accounts — the composer caps at $5,000 ($10,000 MFJ/QSS)"
+}Input schema / properties / ctAmtAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 9: Connecticut alternative minimum tax from Form CT-6251 line 23 (required when federal AMT was paid — agent-computed, transcribed)"
+}Input schema / properties / ctAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 23: overpayment applied to 2026 estimated tax (irrevocable)"
+}Input schema / properties / ctCharityContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 24a: contributions of the refund to designated charities from Schedule 5 line 70 (limited to the refund; irrevocable)"
+}Input schema / properties / ctChetContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 1 line 48: contributions to Connecticut Higher Education Trust (CHET) 529 accounts made during the year plus allowed carryforward — the composer caps at $5,000 ($10,000 MFJ/QSS); the excess carries forward five years"
+}Input schema / properties / ctChetRefundContributionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 24: overpayment contributed to CHET accounts from Schedule CT-CHET line 4 (irrevocable)"
+}Input schema / properties / ctClaimOfRightCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 20b: claim of right credit from Form CT-1040 CRC line 6 (repayment over $3,000 under IRC § 1341; refundable)"
+}Input schema / properties / ctEitcJointFagiAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule CT-EITC line 13: the JOINT federal AGI when the filer filed jointly federally but must file married-filing-separately for Connecticut — the composer prorates the 40% credit by federalAGI (this spouse's separate AGI, line 12) ÷ this amount to four decimals"
+}Input schema / properties / ctEitcQualifyingChildAdded value: +{
+ "description": "at least one qualifying child listed on federal Schedule EIC (Schedule CT-EITC lines 4-5) — adds the flat $250 to the 40% Connecticut EITC (PA 25-168, TY2025+)",
+ "type": "boolean"
+}Input schema / properties / ctHistoricHomesCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 20d: Historic Homes Rehabilitation Tax Credit voucher amount (refundable)"
+}Input schema / properties / ctIraDistributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1040 line 4b taxable IRA distributions other than Roth — 75% (TY2025) / 100% (TY2026) enters the pension and annuity subtraction"
+}Input schema / properties / ctLateAdded value: +{
+ "description": "return/payment is late — the composer applies the 10% late payment penalty to line 26 (line 27); pass ctLateInterest for line 28",
+ "type": "boolean"
+}Input schema / properties / ctLateInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 28: late payment interest — 1% of line 26 per month or fraction of a month from the due date (agent-computed)"
+}Input schema / properties / ctMilitaryRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 1 line 44: military retirement pay included in federal AGI (retired armed forces / National Guard member or survivor-option beneficiary; NOT a former spouse's court-ordered share) — 100% subtracted; also excluded from ctPensionAnnuityIncome"
+}Input schema / properties / ctOtherJurisdictionIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 2 line 53: income included in Connecticut AGI that was also taxed by ONE qualifying jurisdiction (another state, DC, or their political subdivisions — from the Schedule 2 Worksheet column 2); the composer computes lines 54-58 (ratio to four decimals ≤ 1.0000 × (line 6 − line 11), limited to the tax actually paid). Attach the other return."
+}Input schema / properties / ctOtherJurisdictionTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 2 line 57: income tax actually paid to that qualifying jurisdiction"
+}Input schema / properties / ctPensionAnnuityIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1040 line 5b taxable pensions and annuities MINUS military retirement pay, Railroad Retirement, and Connecticut teachers' retirement (the composer runs the Pension and Annuity Worksheet: 100% of this + 75% of ctIraDistributions in TY2025, × the federal-AGI phase-out decimal → Schedule 1 line 48b)"
+}Input schema / properties / ctPropertyTaxAuto1Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 3 line 61: property tax paid on one privately owned or leased (term over one year) motor vehicle"
+}Input schema / properties / ctPropertyTaxAuto2Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 3 line 62: a second vehicle — MFJ / QSS ONLY (the composer ignores it for other statuses with a note)"
+}Input schema / properties / ctPropertyTaxResidenceAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 3 line 60: property tax paid in the year to a Connecticut town on the PRIMARY RESIDENCE (bills due and paid in the year, incl. prepaid installments; no late payments, interest or fees)"
+}Input schema / properties / ctPteCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 20c: pass-through entity tax credit from Schedule CT-PE line 1 (refundable; attach the schedule)"
+}Input schema / properties / ctRailroadRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 1 line 43: Tier 1 and Tier 2 Railroad Retirement benefits, supplemental annuities, and RRB unemployment/sickness benefits included in federal AGI (excluding any Tier 1 already covered by the line 41 Social Security adjustment) — subtracted; also excluded from ctPensionAnnuityIncome"
+}Input schema / properties / ctSsProvisionalExcessAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal Social Security Benefits Worksheet line 9 (provisional income over the $25,000/$32,000 base) — or line 7 for a married-filing-separately filer who lived with the spouse — CT worksheet line B"
+}Input schema / properties / ctSsTotalBenefitsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal Social Security Benefits Worksheet line 1 (total benefits, SSA-1099 box 5) — with taxableSocialSecurity and ctSsProvisionalExcess the composer runs the CT Social Security Benefit Adjustment Worksheet (line 41) when federal AGI is at or above $75,000 (single/MFS) or $100,000 (MFJ/QSS/HOH); below the threshold the full taxable amount is subtracted automatically"
+}Input schema / properties / ctTeachersRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT Schedule 1 line 45: income from the Connecticut Teachers' Retirement System (Form 1099-R from the Teachers' Retirement Board) — the composer subtracts 50%; a teacher under the pension AGI threshold may instead include it in ctPensionAnnuityIncome (never both)"
+}Input schema / properties / ctUnderpaymentInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "CT-1040 line 29: interest on underpayment of estimated tax from Form CT-2210 (applies when line 14 less withholding and PE credit is $1,000 or more; leave blank to let DRS bill it)"
+}Input schema / properties / ctUseTaxTableAdded value: +{
+ "description": "compute line 6 the way the DRS printed tax tables do (CT AGI ≤ $102,000: schedule at the $50 row midpoint, one rounding) instead of the Tax Calculation Schedule's line-level rounding — both are allowed by the form; default is the schedule",
+ "type": "boolean"
+}Input schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok/ct — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or",
- "ok"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok",
+ "ct"
+]calculate_tax28 fields changedInput schema / properties / state / properties / okAgiAdded value: +{
+ "description": "Oklahoma adjusted gross income (Form 511 line 7) — the proration numerator when it is below federal AGI (Schedules 511-F and 511-G: credit x line 7 / line 1, not more than 100%). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okBasicExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Oklahoma exemptions with NO income test: 'yourself' + 'spouse' regular boxes, legally-blind boxes, and dependents (Form 511 page 1) — $1,000 each (us.ok.exemptions). A filer claimable as someone's dependent enters 0 for 'yourself'."
+}Input schema / properties / state / properties / okEic2020AmountAdded value: +{
+ "description": "The federal earned income credit computed under 2020 rules on Form 511-EIC line 20 (the larger of the 2024 and 2025 columns — each is us.ok.eic_2020_rules) — us.ok.eic pays 5% of it, prorated by Oklahoma AGI over federal AGI. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okEicAgiAdded value: +{
+ "description": "Federal AGI (Form 1040 line 11) for the SAME year as okEicEarnedIncome — Form 511-EIC line 17: when it reaches the table's phase-out row ($8,800 no children / $19,350 with children; $14,700 / $25,250 married filing jointly) the credit is the SMALLER of the table amounts at earned income and at AGI (us.ok.eic_2020_rules). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okEicEarnedIncomeAdded value: +{
+ "description": "Total earned income on Form 511-EIC line 15 (wages less excluded Medicaid waiver payments, plus elected nontaxable combat pay, plus net self-employment earnings) for the year being computed — Oklahoma lets the filer use 2025 OR 2024 earned income (us.ok.eic_2020_rules; run once per year and keep the larger). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okEicEligibleAdded value: +{
+ "description": "Filer meets the FEDERAL 2020-law EIC requirements Oklahoma freezes to (68 O.S. § 2357.43): work-valid SSNs, not married filing separately, investment income $3,650 or less, and — with no qualifying child — age 25 to 64 and not a dependent (us.ok.eic_2020_rules). Unattested = $0.",
+ "type": "boolean"
+}Input schema / properties / state / properties / okEicQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of EIC qualifying children under the 2020 federal rules (0, 1, 2, or 3-or-more — the table caps at 3) for us.ok.eic_2020_rules."
+}Input schema / properties / state / properties / okFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income (Form 511 line 1 = Form 1040 line 11) — keys the $100,000 child care/child tax credit cliff and the Schedule 511-F/511-G proration denominators (us.ok.child_care_child_tax_credit, us.ok.eic), the special 65+ exemption income limits (us.ok.exemptions, after removing Roth conversion income), and the use tax table (us.ok.use_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalCharityAdded value: +{
+ "description": "Gifts to charity deducted on federal Schedule A line 14 (Schedule 511-D lines 5 and 10) — exempt from Oklahoma's $17,000 itemized cap (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalChildCareCreditAdded value: +{
+ "description": "Federal credit for child and dependent care expenses allowed (Form 2441 / Schedule 3 line 2) — Oklahoma allows 20% of it (us.ok.child_care_child_tax_credit, the greater-of test). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalChildTaxCreditAdded value: +{
+ "description": "Federal child tax credit PLUS additional child tax credit allowed (Form 1040 line 19 + line 28 from Schedule 8812) — Oklahoma allows 5% of the total (us.ok.child_care_child_tax_credit, the greater-of test). NOTE: line 19 also carries the $500 § 24(h)(4) credit for other dependents; the packet names only the CTC and ACTC — the ODC is part of § 24 (\"the child tax credit allowed under the IRC\"), so include it but disclose when one is present. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalItemizedTotalAdded value: +{
+ "description": "Federal Schedule A line 17 total itemized deductions (Schedule 511-D line 1) — the starting point for Oklahoma itemized deductions (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalMedicalAdded value: +{
+ "description": "Medical and dental expenses deducted on federal Schedule A line 4 (Schedule 511-D lines 4 and 9) — exempt from Oklahoma's $17,000 itemized cap (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalSaltDeductedAdded value: +{
+ "description": "State and local income OR general sales taxes from federal Schedule A line 5a to the extent actually included in line 5e after the SALT cap (Schedule 511-D line 2) — Oklahoma adds them back (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okGovRetirementSpouseAdded value: +{
+ "description": "SPOUSE's Oklahoma-government or federal civil service retirement benefits included in federal AGI (Schedule 511-A line 5) — the $10,000 limit is per individual, in that person's name (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okGovRetirementYouAdded value: +{
+ "description": "TAXPAYER's Oklahoma-government or federal civil service retirement benefits included in federal AGI (Schedule 511-A line 5 systems: OPERS, TRS, OLERS, firefighters, police, judges, county/municipal systems, US civil service other than CSRS-in-lieu-of-SS) — excluded up to $10,000 per person (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okGrossHouseholdIncomeAdded value: +{
+ "description": "Total GROSS household income of everyone in the household, taxable or not (Form 538-S Part 3 line 14: wages incl. nontaxable W-2 amounts, interest, dependents' income, full Social Security incl. Medicare, pensions, alimony, unemployment, EIC received, public assistance, child support, workers' comp, gross rents/business receipts; NOT deferred 401(k)/IRA contributions) — the $20,000/$50,000 sales tax relief limits (us.ok.sales_tax_relief_credit) and the $12,000 property tax relief limit (us.ok.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okOtherRetirementSpouseAdded value: +{
+ "description": "SPOUSE's other qualifying retirement income included in federal AGI (Schedule 511-A line 6) — same per-person $10,000 combined limit (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okOtherRetirementYouAdded value: +{
+ "description": "TAXPAYER's other qualifying retirement income included in federal AGI (Schedule 511-A line 6: IRC 401 plans, 457 plans, 408 IRAs/SEPs, 403(a)/(b) annuities, 402(e) lump sums) — excluded up to $10,000 per person MINUS the same person's line 5 exclusion (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okPropertyTaxPaidAdded value: +{
+ "description": "Ad valorem property taxes paid on the homestead occupied during the year (Form 538-H) — the property tax relief credit is the amount paid, capped at $200 (us.ok.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okPtrEligibleAdded value: +{
+ "description": "Filer is 65 or older OR totally disabled, is the head of a household, and was an Oklahoma resident domiciled in the state for the ENTIRE preceding calendar year (Form 538-H / Form 511 line 24) — the property tax relief credit also requires gross household income of $12,000 or less (us.ok.property_tax_relief_credit). Unattested = $0.",
+ "type": "boolean"
+}Input schema / properties / state / properties / okRothConversionIncomeAdded value: +{
+ "description": "Income from converting a traditional IRA to a Roth IRA that is included in federal AGI — excluded from federal AGI ONLY for the special 65+ exemption income limits (68 O.S. § 2358(E)(1)(c); Form 511 exemption instructions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okSpecialExemptions65Added value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Oklahoma SPECIAL exemption boxes (taxpayer and/or spouse 65 or older at year end, 0-2) — $1,000 each ONLY when federal AGI (less Roth conversion income) is at or under $15,000 single / $25,000 joint / $12,500 MFS / $19,000 head of household (us.ok.exemptions)."
+}Input schema / properties / state / properties / okStrDisabledAdded value: +{
+ "description": "Filer or spouse has a physical disability constituting a substantial handicap to employment (proof required with Form 538-S) — raises the sales tax relief gross household income limit to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / okStrEligibleAdded value: +{
+ "description": "Filer meets the Form 538-S gates: Oklahoma resident (domiciled) for the ENTIRE year, not an inmate in DOC custody during the year after a felony conviction, received no TANF in any month, not living in Oklahoma under a visa, and the return is filed by the due date (us.ok.sales_tax_relief_credit). Unattested = $0.",
+ "type": "boolean"
+}Input schema / properties / state / properties / okStrExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Qualified exemptions for the sales tax relief credit (Form 538-S Box D: yourself, spouse, and each federally-claimed dependent who was an Oklahoma resident all year; a deceased taxpayer/spouse or a TANF recipient does not count) — $40 each (us.ok.sales_tax_relief_credit)."
+}Input schema / properties / state / properties / okStrHasDependentAdded value: +{
+ "description": "Filer can claim an exemption for a dependent — raises the sales tax relief gross household income limit from $20,000 to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / okStrIs65Added value: +{
+ "description": "Filer or spouse is 65 or older by December 31 of the tax year — raises the sales tax relief gross household income limit to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}compute_return28 fields changedInput schema / properties / state / properties / okAgiAdded value: +{
+ "description": "Oklahoma adjusted gross income (Form 511 line 7) — the proration numerator when it is below federal AGI (Schedules 511-F and 511-G: credit x line 7 / line 1, not more than 100%). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okBasicExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Oklahoma exemptions with NO income test: 'yourself' + 'spouse' regular boxes, legally-blind boxes, and dependents (Form 511 page 1) — $1,000 each (us.ok.exemptions). A filer claimable as someone's dependent enters 0 for 'yourself'."
+}Input schema / properties / state / properties / okEic2020AmountAdded value: +{
+ "description": "The federal earned income credit computed under 2020 rules on Form 511-EIC line 20 (the larger of the 2024 and 2025 columns — each is us.ok.eic_2020_rules) — us.ok.eic pays 5% of it, prorated by Oklahoma AGI over federal AGI. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okEicAgiAdded value: +{
+ "description": "Federal AGI (Form 1040 line 11) for the SAME year as okEicEarnedIncome — Form 511-EIC line 17: when it reaches the table's phase-out row ($8,800 no children / $19,350 with children; $14,700 / $25,250 married filing jointly) the credit is the SMALLER of the table amounts at earned income and at AGI (us.ok.eic_2020_rules). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okEicEarnedIncomeAdded value: +{
+ "description": "Total earned income on Form 511-EIC line 15 (wages less excluded Medicaid waiver payments, plus elected nontaxable combat pay, plus net self-employment earnings) for the year being computed — Oklahoma lets the filer use 2025 OR 2024 earned income (us.ok.eic_2020_rules; run once per year and keep the larger). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okEicEligibleAdded value: +{
+ "description": "Filer meets the FEDERAL 2020-law EIC requirements Oklahoma freezes to (68 O.S. § 2357.43): work-valid SSNs, not married filing separately, investment income $3,650 or less, and — with no qualifying child — age 25 to 64 and not a dependent (us.ok.eic_2020_rules). Unattested = $0.",
+ "type": "boolean"
+}Input schema / properties / state / properties / okEicQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of EIC qualifying children under the 2020 federal rules (0, 1, 2, or 3-or-more — the table caps at 3) for us.ok.eic_2020_rules."
+}Input schema / properties / state / properties / okFederalAgiAdded value: +{
+ "description": "Federal adjusted gross income (Form 511 line 1 = Form 1040 line 11) — keys the $100,000 child care/child tax credit cliff and the Schedule 511-F/511-G proration denominators (us.ok.child_care_child_tax_credit, us.ok.eic), the special 65+ exemption income limits (us.ok.exemptions, after removing Roth conversion income), and the use tax table (us.ok.use_tax). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalCharityAdded value: +{
+ "description": "Gifts to charity deducted on federal Schedule A line 14 (Schedule 511-D lines 5 and 10) — exempt from Oklahoma's $17,000 itemized cap (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalChildCareCreditAdded value: +{
+ "description": "Federal credit for child and dependent care expenses allowed (Form 2441 / Schedule 3 line 2) — Oklahoma allows 20% of it (us.ok.child_care_child_tax_credit, the greater-of test). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalChildTaxCreditAdded value: +{
+ "description": "Federal child tax credit PLUS additional child tax credit allowed (Form 1040 line 19 + line 28 from Schedule 8812) — Oklahoma allows 5% of the total (us.ok.child_care_child_tax_credit, the greater-of test). NOTE: line 19 also carries the $500 § 24(h)(4) credit for other dependents; the packet names only the CTC and ACTC — the ODC is part of § 24 (\"the child tax credit allowed under the IRC\"), so include it but disclose when one is present. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalItemizedTotalAdded value: +{
+ "description": "Federal Schedule A line 17 total itemized deductions (Schedule 511-D line 1) — the starting point for Oklahoma itemized deductions (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalMedicalAdded value: +{
+ "description": "Medical and dental expenses deducted on federal Schedule A line 4 (Schedule 511-D lines 4 and 9) — exempt from Oklahoma's $17,000 itemized cap (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okFederalSaltDeductedAdded value: +{
+ "description": "State and local income OR general sales taxes from federal Schedule A line 5a to the extent actually included in line 5e after the SALT cap (Schedule 511-D line 2) — Oklahoma adds them back (us.ok.itemized_deductions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okGovRetirementSpouseAdded value: +{
+ "description": "SPOUSE's Oklahoma-government or federal civil service retirement benefits included in federal AGI (Schedule 511-A line 5) — the $10,000 limit is per individual, in that person's name (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okGovRetirementYouAdded value: +{
+ "description": "TAXPAYER's Oklahoma-government or federal civil service retirement benefits included in federal AGI (Schedule 511-A line 5 systems: OPERS, TRS, OLERS, firefighters, police, judges, county/municipal systems, US civil service other than CSRS-in-lieu-of-SS) — excluded up to $10,000 per person (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okGrossHouseholdIncomeAdded value: +{
+ "description": "Total GROSS household income of everyone in the household, taxable or not (Form 538-S Part 3 line 14: wages incl. nontaxable W-2 amounts, interest, dependents' income, full Social Security incl. Medicare, pensions, alimony, unemployment, EIC received, public assistance, child support, workers' comp, gross rents/business receipts; NOT deferred 401(k)/IRA contributions) — the $20,000/$50,000 sales tax relief limits (us.ok.sales_tax_relief_credit) and the $12,000 property tax relief limit (us.ok.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okOtherRetirementSpouseAdded value: +{
+ "description": "SPOUSE's other qualifying retirement income included in federal AGI (Schedule 511-A line 6) — same per-person $10,000 combined limit (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okOtherRetirementYouAdded value: +{
+ "description": "TAXPAYER's other qualifying retirement income included in federal AGI (Schedule 511-A line 6: IRC 401 plans, 457 plans, 408 IRAs/SEPs, 403(a)/(b) annuities, 402(e) lump sums) — excluded up to $10,000 per person MINUS the same person's line 5 exclusion (us.ok.retirement_exclusion). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okPropertyTaxPaidAdded value: +{
+ "description": "Ad valorem property taxes paid on the homestead occupied during the year (Form 538-H) — the property tax relief credit is the amount paid, capped at $200 (us.ok.property_tax_relief_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okPtrEligibleAdded value: +{
+ "description": "Filer is 65 or older OR totally disabled, is the head of a household, and was an Oklahoma resident domiciled in the state for the ENTIRE preceding calendar year (Form 538-H / Form 511 line 24) — the property tax relief credit also requires gross household income of $12,000 or less (us.ok.property_tax_relief_credit). Unattested = $0.",
+ "type": "boolean"
+}Input schema / properties / state / properties / okRothConversionIncomeAdded value: +{
+ "description": "Income from converting a traditional IRA to a Roth IRA that is included in federal AGI — excluded from federal AGI ONLY for the special 65+ exemption income limits (68 O.S. § 2358(E)(1)(c); Form 511 exemption instructions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / okSpecialExemptions65Added value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Oklahoma SPECIAL exemption boxes (taxpayer and/or spouse 65 or older at year end, 0-2) — $1,000 each ONLY when federal AGI (less Roth conversion income) is at or under $15,000 single / $25,000 joint / $12,500 MFS / $19,000 head of household (us.ok.exemptions)."
+}Input schema / properties / state / properties / okStrDisabledAdded value: +{
+ "description": "Filer or spouse has a physical disability constituting a substantial handicap to employment (proof required with Form 538-S) — raises the sales tax relief gross household income limit to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / okStrEligibleAdded value: +{
+ "description": "Filer meets the Form 538-S gates: Oklahoma resident (domiciled) for the ENTIRE year, not an inmate in DOC custody during the year after a felony conviction, received no TANF in any month, not living in Oklahoma under a visa, and the return is filed by the due date (us.ok.sales_tax_relief_credit). Unattested = $0.",
+ "type": "boolean"
+}Input schema / properties / state / properties / okStrExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Qualified exemptions for the sales tax relief credit (Form 538-S Box D: yourself, spouse, and each federally-claimed dependent who was an Oklahoma resident all year; a deceased taxpayer/spouse or a TANF recipient does not count) — $40 each (us.ok.sales_tax_relief_credit)."
+}Input schema / properties / state / properties / okStrHasDependentAdded value: +{
+ "description": "Filer can claim an exemption for a dependent — raises the sales tax relief gross household income limit from $20,000 to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / okStrIs65Added value: +{
+ "description": "Filer or spouse is 65 or older by December 31 of the tax year — raises the sales tax relief gross household income limit to $50,000 (us.ok.sales_tax_relief_credit).",
+ "type": "boolean"
+}compute_state_return52 fields changedInput schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or/ok — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al",
- "or"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or",
+ "ok"
+]Input schema / properties / ok529ContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-C line 3: Oklahoma 529 College Savings Plan / OklahomaDream 529 contributions (incl. carryforwards and contributions through April 15) — the composer caps at $10,000 ($20,000 joint)"
+}Input schema / properties / okAdditionalTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 14b: HSA non-qualified withdrawal 10% additional tax (box 2), Oklahoma Affordable Housing credit recapture (box 3), or IRC § 965(h) installment (box 4)"
+}Input schema / properties / okAmendedPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 30 (amended return only): amount paid with the original return plus additional payments after it was filed"
+}Input schema / properties / okAmendedPriorOverpaymentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 32 (amended return only): overpayment shown on the original / prior amended return or as previously adjusted"
+}Input schema / properties / okAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 35: overpayment applied to 2026 estimated tax (original return only)"
+}Input schema / properties / okBlindExemptionsAdded value: +{
+ "description": "count of legally-blind boxes (taxpayer/spouse) — $1,000 each, added to the shared `exemptions` count (self + spouse + dependents)",
+ "type": "integer"
+}Input schema / properties / okCsrsRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-A line 3: Federal Civil Service Retirement System benefits paid in lieu of Social Security (100% excluded; CSA/CSF 1099-R claim number required — FERS does not qualify except the CSRS component or the FERS annuity supplement)"
+}Input schema / properties / okDonationsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 36: Schedule 511-H donations from the refund (CASA programs, Wildlife Diversity Fund — $2/$5/other)"
+}Input schema / properties / okEicAgi2024Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 511-EIC line 17 (Tax Year 2024 column): 2024 federal AGI — REQUIRED with okEicEarnedIncome2024 (the composer skips the 2024 column without it, since the line 19 AGI look-up cannot run)"
+}Input schema / properties / okEicEarnedIncome2024Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 511-EIC line 15 (Tax Year 2024 column): the PRIOR year's total earned income — Oklahoma lets the filer use 2024 or 2025 earned income; when given (with okEicAgi2024) the composer computes both columns and keeps the larger (line 20). Omit if the filer had no 2024 Oklahoma filing requirement."
+}Input schema / properties / okEicEarnedIncome2025Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 511-EIC line 15 (Tax Year 2025 column): total earned income — 1040 line 1z wages less excluded Medicaid waiver payments, plus elected nontaxable combat pay, plus net self-employment earnings (Schedule SE line 3 + 4b + 5a − line 13, statutory employee Schedule C line 1). The composer looks it up in the printed 2020 EIC table (us.ok.eic_2020_rules) with federalAGI as line 17."
+}Input schema / properties / okEicEligibleAdded value: +{
+ "description": "Form 511-EIC eligibility under the FEDERAL 2020 rules attested: work-valid SSNs, not married filing separately, investment income $3,650 or less, and with no qualifying child age 25-64 and not a dependent — enables the Oklahoma EIC (line 28)",
+ "type": "boolean"
+}Input schema / properties / okEicQualifyingChildrenAdded value: +{
+ "description": "EIC qualifying children under the 2020 federal rules (0, 1, 2, or 3+)",
+ "type": "integer"
+}Input schema / properties / okFarmIncomeAveragingTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OVERRIDE for line 14a: Form 573 farm income averaging tax (box 1) — agent-computed; replaces the table tax"
+}Input schema / properties / okFederalCharityAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal Schedule A line 14 gifts to charity — exempt from the $17,000 Oklahoma cap"
+}Input schema / properties / okFederalChildCareCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal child and dependent care credit allowed (Schedule 3 line 2 / Form 2441) — Oklahoma allows 20% (line 15, greater-of test; $100,000 federal AGI cliff)"
+}Input schema / properties / okFederalChildTaxCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal child tax credit PLUS additional child tax credit allowed (1040 line 19 + line 28, Schedule 8812) — Oklahoma allows 5% (line 15, greater-of test). Line 19 includes the $500 § 24(h)(4) other-dependent credit; the packet names only the CTC/ACTC — include it (it is part of § 24) and disclose when present"
+}Input schema / properties / okFederalItemizedAdded value: +{
+ "description": "taxpayer ITEMIZED on the federal return — Oklahoma then REQUIRES Oklahoma itemized deductions (Schedule 511-D) even if smaller than the standard deduction; a federal standard-deduction filer must take the Oklahoma standard deduction",
+ "type": "boolean"
+}Input schema / properties / okFederalItemizedTotalAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal Schedule A line 17 total itemized deductions (Schedule 511-D line 1)"
+}Input schema / properties / okFederalMedicalAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal Schedule A line 4 medical and dental (after the 7.5% floor) — exempt from the $17,000 Oklahoma cap"
+}Input schema / properties / okFederalSaltDeductedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "state and local income OR sales taxes from Schedule A line 5a to the extent included in line 5e after the SALT cap (Schedule 511-D line 2 add-back)"
+}Input schema / properties / okForm578CreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 27: refundable credit for electricity generated by zero-emission facilities from Form 578 (85% of face; transcribed)"
+}Input schema / properties / okGovRetirementSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-A line 5, SPOUSE: the spouse's own government retirement (separate $10,000 cap)"
+}Input schema / properties / okGovRetirementYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-A line 5, TAXPAYER: Oklahoma-government / U.S. civil service retirement in the taxpayer's own name (OPERS, TRS, police, fire, judges, county/municipal systems) — excluded up to $10,000 per person (us.ok.retirement_exclusion)"
+}Input schema / properties / okGrossHouseholdIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Forms 538-S / 538-H: TOTAL gross household income of everyone in the household, taxable or not — wages incl. nontaxable W-2 amounts, interest, dependents' income, full Social Security incl. Medicare premiums, pensions/IRAs, alimony, unemployment, EIC received, public assistance, child support, workers' comp, gross rents/business receipts; NOT deferred 401(k)/IRA contributions or gifts"
+}Input schema / properties / okHomeschoolCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 29: Parental Choice Tax Credit for homeschool expenses from Form 591-D (refundable) — the composer caps at $1,000 × okHomeschoolStudents when the count is given"
+}Input schema / properties / okHomeschoolStudentsAdded value: +{
+ "description": "OK line 29: number of eligible homeschool students claimed (one Form 591-D each)",
+ "type": "integer"
+}Input schema / properties / okInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 41b: delinquent payment interest (1.25% per month from the original due date)"
+}Input schema / properties / okMilitaryPayAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-C line 1: active-duty, Reserve, and National Guard military pay included in federal AGI (100% excluded)"
+}Input schema / properties / okMilitaryRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-A line 4: military retirement benefits included in federal AGI (100% excluded)"
+}Input schema / properties / okNaturalDisasterCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 26: Natural Disaster Tax Credit from Form 576 (refundable; transcribed)"
+}Input schema / properties / okOtherAdjustmentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-C lines 2, 4-6 total: disability modification expenses, foster care (≤ $5,000), Parental Choice payments, and the misc codes (MSA/HSA, ag processing, organ donation ≤ $10,000, poll-worker leave, homebuyer savings $5,000/$10,000, ABLE $10,000/$20,000, etc.) — transcribed"
+}Input schema / properties / okOtherRetirementSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-A line 6, SPOUSE: the spouse's own other retirement income"
+}Input schema / properties / okOtherRetirementYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-A line 6, TAXPAYER: other qualified plan / IRA / 403(b) / 457 / lump-sum retirement income — the $10,000 per-person cap is shared with line 5"
+}Input schema / properties / okOtherStateCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 16: Form 511-TX credit for tax paid to another state on PERSONAL-SERVICES income (agent-computed per the form's proportion; capped at the remaining tax by the composer)"
+}Input schema / properties / okOutOfStateIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Form 511 line 4: income from real or tangible personal property or BUSINESS activity in another state (partnership/S-corp shares included) — NEVER wages, interest, dividends, pensions, unemployment, or gambling. When > 0 the composer prorates deductions and exemptions on Schedule 511-E and leaves lines 10-11 blank."
+}Input schema / properties / okPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 41a: delinquent payment penalty (5% of line 39 minus line 19 after the original due date)"
+}Input schema / properties / okPropertyTaxPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 538-H line 15: 2025 real estate (ad valorem) taxes paid on the homestead (no personal property taxes) — credit = amount over 1% of gross household income, max $200"
+}Input schema / properties / okPtrEligibleAdded value: +{
+ "description": "Form 538-H gates attested: 65 or older OR totally disabled, head of a household (owner who maintained the home — the 538-H definition, not the filing status), domiciled in Oklahoma the entire year — enables the property tax relief credit (line 24; also needs gross household income ≤ $12,000)",
+ "type": "boolean"
+}Input schema / properties / okRailroadRetirementAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-A line 7: U.S. Railroad Retirement Board benefits included in federal AGI (excluded)"
+}Input schema / properties / okRothConversionIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Roth IRA conversion income included in federal AGI — excluded from AGI for the special 65+ exemption limits only (attach Form 8606)"
+}Input schema / properties / okSpecialExemptions65Added value: +{
+ "description": "count of 65-or-older boxes (taxpayer/spouse, 0-2) — $1,000 each ONLY when federal AGI less Roth conversions is at or under $15,000 single / $25,000 joint / $12,500 MFS / $19,000 HOH (not listed for QSS — the composer denies it and discloses)",
+ "type": "integer"
+}Input schema / properties / okStrDisabledAdded value: +{
+ "description": "taxpayer or spouse has a physical disability constituting a substantial handicap to employment (proof attached) — raises the sales tax relief limit to $50,000",
+ "type": "boolean"
+}Input schema / properties / okStrEligibleAdded value: +{
+ "description": "Form 538-S gates attested: Oklahoma resident (domiciled) the ENTIRE year, no TANF in any month, not a DOC inmate during the year after a felony conviction, not living in Oklahoma under a visa, and the return is filed by the due date — enables the sales tax relief credit (line 25)",
+ "type": "boolean"
+}Input schema / properties / okStrExemptionsAdded value: +{
+ "description": "Form 538-S Box D qualified exemptions (yourself + spouse + federally-claimed dependents who were Oklahoma residents all year; the 65+/blind boxes NEVER count) — $40 each; defaults to the shared `exemptions` count",
+ "type": "integer"
+}Input schema / properties / okStrHasDependentAdded value: +{
+ "description": "filer can claim a dependent — raises the sales tax relief gross household income limit from $20,000 to $50,000",
+ "type": "boolean"
+}Input schema / properties / okStrIs65Added value: +{
+ "description": "taxpayer or spouse 65 or older by December 31 — raises the sales tax relief limit to $50,000",
+ "type": "boolean"
+}Input schema / properties / okUnderpaymentInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK line 40: underpayment-of-estimated-tax interest from Form OW-8-P (none when the income tax liability is under $1,000; when there is also an overpayment the composer nets it against the refund per the printed instruction)"
+}Input schema / properties / okUsInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OK Schedule 511-A line 1: interest on U.S. government obligations included in federal AGI (not FNMA/GNMA)"
+}Input schema / properties / okUseTaxEstimateAdded value: +{
+ "description": "filer kept no records of out-of-state purchases and elects the printed Use Tax Table estimate on federal AGI for line 19 (us.ok.use_tax — the 2025 table; for a TY2026 return the estimate REFUSES until the 2026 packet publishes, pass useTax instead) — otherwise pass useTax (worksheet amount) or nothing (certify no use tax is due)",
+ "type": "boolean"
+}calculate_tax11 fields changedInput schema / properties / state / properties / or2024TaxLiabilityAdded value: +{
+ "description": "The 2024 total Oregon personal income tax liability: 2024 OR-40 line 24 tax-before-credits MINUS the Schedule OR-ASC code 802/815 credit for taxes paid to another state (Kicker worksheet Part A — NOT line 31, which is after the exemption and other credits) — us.or.kicker pays 9.863% of it on the 2025 return. Requires the 2024 return filed before the 2025 return. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orAgiAdded value: +{
+ "description": "Federal adjusted gross income (Form OR-40 line 7) — keys the federal tax subtraction Table 4 phase-out (us.or.federal_tax_subtraction) and the exemption credit cliffs (us.or.exemption_credit: $100,000 single/MFS, $200,000 others; disability exemptions $100,000 for all). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orDependentEarnedIncomeAdded value: +{
+ "description": "A dependent-claimed filer's earned income for Oregon's dependent standard-deduction limit (larger of $1,350 or earned + $450, capped at the Table 5 amount). Only used when isClaimedAsDependent. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orDisabilityExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Oregon severe-disability exemption boxes (6a/6b) plus children with a qualifying disability (line 6d) — $256 each, $0 above $100,000 federal AGI for EVERY filing status (us.or.exemption_credit)."
+}Input schema / properties / state / properties / orFederalEicAdded value: +{
+ "description": "The federal earned income credit (Form 1040 line 27a) — us.or.eic pays 9% of it (12% when the youngest dependent is under 3). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orFederalTaxLiabilityAdded value: +{
+ "description": "The Oregon federal tax liability worksheet line 10 result: 1040 line 22 minus excess-APTC repayment (floor 0), plus Schedule 2 lines 8/16/17 income taxes, minus AOC + refundable adoption + Form 8962 line 24 PTC (floor 0 — the EITC and ACTC are NOT subtracted) — us.or.federal_tax_subtraction caps it at $8,500/$4,250-MFS with the Table 4 AGI phase-out. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orKidsQualifyingIncomeAdded value: +{
+ "description": "Oregon Kids Credit worksheet line 4 qualifying income: OR-40 line 15 income-after-subtractions + OR-ASC code 390/391/392 (tips/overtime/vehicle-interest) addbacks + the Part B loss-and-exclusion addback (losses beyond $20,000 and all excluded foreign earned income) — us.or.kids_credit phases out $26,550-$31,550. May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orKidsUnder6Added value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependents age 5 or younger at the end of 2025 for the Oregon Kids Credit — $1,050 each, capped at 5 children by us.or.kids_credit (refundable; MFS denied; released-exemption children do not count)."
+}Input schema / properties / state / properties / orRegularExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Oregon regular exemption count (OR-40 boxes 6a/6b 'regular' + line 6c dependents) — $256 each for 2025, $0 above the $100,000/$200,000 federal AGI cliff (us.or.exemption_credit)."
+}Input schema / properties / state / properties / orStdBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Oregon standard-deduction boxes 17a-d (you/spouse turned 65 by January 1, 2026, and/or blind) — each adds $1,200 (single/HOH) or $1,000 (other statuses) (us.or.standard_deduction)."
+}Input schema / properties / state / properties / orYoungestUnder3Added value: +{
+ "description": "The filer's youngest dependent was younger than 3 at the end of the tax year — raises the Oregon EIC percentage from 9% to 12% of the federal EITC (us.or.eic, Table 9).",
+ "type": "boolean"
+}compute_return11 fields changedInput schema / properties / state / properties / or2024TaxLiabilityAdded value: +{
+ "description": "The 2024 total Oregon personal income tax liability: 2024 OR-40 line 24 tax-before-credits MINUS the Schedule OR-ASC code 802/815 credit for taxes paid to another state (Kicker worksheet Part A — NOT line 31, which is after the exemption and other credits) — us.or.kicker pays 9.863% of it on the 2025 return. Requires the 2024 return filed before the 2025 return. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orAgiAdded value: +{
+ "description": "Federal adjusted gross income (Form OR-40 line 7) — keys the federal tax subtraction Table 4 phase-out (us.or.federal_tax_subtraction) and the exemption credit cliffs (us.or.exemption_credit: $100,000 single/MFS, $200,000 others; disability exemptions $100,000 for all). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orDependentEarnedIncomeAdded value: +{
+ "description": "A dependent-claimed filer's earned income for Oregon's dependent standard-deduction limit (larger of $1,350 or earned + $450, capped at the Table 5 amount). Only used when isClaimedAsDependent. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orDisabilityExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Oregon severe-disability exemption boxes (6a/6b) plus children with a qualifying disability (line 6d) — $256 each, $0 above $100,000 federal AGI for EVERY filing status (us.or.exemption_credit)."
+}Input schema / properties / state / properties / orFederalEicAdded value: +{
+ "description": "The federal earned income credit (Form 1040 line 27a) — us.or.eic pays 9% of it (12% when the youngest dependent is under 3). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orFederalTaxLiabilityAdded value: +{
+ "description": "The Oregon federal tax liability worksheet line 10 result: 1040 line 22 minus excess-APTC repayment (floor 0), plus Schedule 2 lines 8/16/17 income taxes, minus AOC + refundable adoption + Form 8962 line 24 PTC (floor 0 — the EITC and ACTC are NOT subtracted) — us.or.federal_tax_subtraction caps it at $8,500/$4,250-MFS with the Table 4 AGI phase-out. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orKidsQualifyingIncomeAdded value: +{
+ "description": "Oregon Kids Credit worksheet line 4 qualifying income: OR-40 line 15 income-after-subtractions + OR-ASC code 390/391/392 (tips/overtime/vehicle-interest) addbacks + the Part B loss-and-exclusion addback (losses beyond $20,000 and all excluded foreign earned income) — us.or.kids_credit phases out $26,550-$31,550. May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / orKidsUnder6Added value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Dependents age 5 or younger at the end of 2025 for the Oregon Kids Credit — $1,050 each, capped at 5 children by us.or.kids_credit (refundable; MFS denied; released-exemption children do not count)."
+}Input schema / properties / state / properties / orRegularExemptionsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Oregon regular exemption count (OR-40 boxes 6a/6b 'regular' + line 6c dependents) — $256 each for 2025, $0 above the $100,000/$200,000 federal AGI cliff (us.or.exemption_credit)."
+}Input schema / properties / state / properties / orStdBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Oregon standard-deduction boxes 17a-d (you/spouse turned 65 by January 1, 2026, and/or blind) — each adds $1,200 (single/HOH) or $1,000 (other statuses) (us.or.standard_deduction)."
+}Input schema / properties / state / properties / orYoungestUnder3Added value: +{
+ "description": "The filer's youngest dependent was younger than 3 at the end of the tax year — raises the Oregon EIC percentage from 9% to 12% of the federal EITC (us.or.eic, Table 9).",
+ "type": "boolean"
+}compute_state_return36 fields changedInput schema / properties / federalAGI / descriptionPrevious value: -"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."New value: +"federal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead)."Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc",
- "al"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al",
+ "or"
+]Input schema / properties / or2024TaxLiabilityAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the filer's 2024 total Oregon personal income tax liability (after the other-state credit, before all other credits/payments — 2024 OR-40 line 24 tax-before-credits MINUS the Schedule OR-ASC code 802/815 credit for taxes paid to another state, per Table 8 / Kicker worksheet Part A) — the composer computes the 9.863% kicker (us.or.kicker). Requires the 2024 return filed before the 2025 return. Prorate by 2024 Oregon-AGI share if the filing status changed (worksheet Parts B/C)."
+}Input schema / properties / or529DepositsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 51: Oregon 529 deposits from Schedule OR-529 (reduce the refund)"
+}Input schema / properties / orAdditionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 8: Schedule OR-ASC line A5 additions (non-Oregon municipal interest, federal-state depreciation differences, 529 recapture)"
+}Input schema / properties / orAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 48: refund applied to 2026 estimated tax"
+}Input schema / properties / orCarryforwardCreditsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 30: Schedule OR-ASC line E9 carryforward credits used this year (capped at the remaining tax by the composer)"
+}Input schema / properties / orCharitableCheckoffsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 49: Schedule OR-DONATE charitable checkoffs (reduce the refund)"
+}Input schema / properties / orCreditRecapturesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 22: tax recaptures from Schedule OR-ASC line C5"
+}Input schema / properties / orDependentEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "dependent-claimed filer's earned income — the standard deduction is limited to max($1,350, earned + $450), capped at the Table 5 amount"
+}Input schema / properties / orDisabilityExemptionsAdded value: +{
+ "description": "severe-disability boxes (6a/6b) + children with a qualifying disability (6d) — $256 each, $0 cliff above $100,000 federal AGI for EVERY filing status",
+ "type": "integer"
+}Input schema / properties / orExcessAptcRepaymentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "excess advance premium tax credit repayment (1040 Schedule 2 line 1a) — SUBTRACTED in the worksheet (floor 0)"
+}Input schema / properties / orFederal1040Line22Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal Form 1040 LINE 22 (tax after nonrefundable credits) — the federal tax subtraction worksheet's line 1 (from compute_return, verbatim)"
+}Input schema / properties / orFederalAocAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "American Opportunity Credit (1040 line 29) — subtracted in the federal tax worksheet"
+}Input schema / properties / orFederalOtherIncomeTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "other INCOME taxes from Schedule 2 lines 8, 16, 17 (income-tax recaptures only — never SE tax, SS/Medicare tip tax, household employment taxes, penalties, or excise)"
+}Input schema / properties / orFederalPtcAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "premium tax credit from Form 8962 LINE 24 (the full allowable credit regardless of advance payments) — subtracted. NOTE: the EITC and additional child tax credit are NOT subtracted."
+}Input schema / properties / orFederalRefundableAdoptionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "refundable adoption credit (1040 line 30) — subtracted"
+}Input schema / properties / orFederalTaxLiabilityOverrideAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OVERRIDE for the worksheet line 10 result (amended federal returns, foreign income tax, 1040-NR, recapture situations — Publication OR-17 worksheets); the Table 4 AGI cap still applies via the oracle"
+}Input schema / properties / orInstallmentInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 21: interest on installment-sale deferred tax liability (9% annual rate for 2025)"
+}Input schema / properties / orInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 44: interest on UNDERPAYMENT OF ESTIMATED TAX from Form OR-10 (boxes 44a/44b) — late-payment interest goes in line 43 instead"
+}Input schema / properties / orItemizedDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule OR-A line 23 OREGON itemized deductions (Oregon's own computation — never the federal Schedule A total). The composer takes the larger of this and the standard deduction."
+}Input schema / properties / orKickerDonateAdded value: +{
+ "description": "filer elects to donate the ENTIRE kicker to the State School Fund (irrevocable after the due date) — line 32 becomes $0 and box 55 is checked",
+ "type": "boolean"
+}Input schema / properties / orKidsLossAddbackAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Kids Credit worksheet Part B: federal losses + OR-ASC loss-subtraction codes beyond the $20,000 allowance, plus ALL excluded foreign earned income — added back to qualifying income"
+}Input schema / properties / orKidsObbbaAddbackAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Kids Credit worksheet line 2: tips/overtime/vehicle-interest subtractions claimed (OR-ASC codes 390/391/392) — ADDED BACK to qualifying income"
+}Input schema / properties / orKidsUnder6Added value: +{
+ "description": "dependents age 5 or younger at the end of 2025 (max 5 count) — $1,050 each Oregon Kids Credit (us.or.kids_credit, refundable, MFS denied). A child claimed only via a RELEASED dependent exemption does not count.",
+ "type": "integer"
+}Input schema / properties / orPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 43: penalty AND interest for filing or paying late (one combined printed line — 5% late-pay penalty, +20% over 3 months late, 100% for 3 consecutive unfiled years, plus the late-payment interest)"
+}Input schema / properties / orPoliticalContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "2025 cash contributions to qualified Oregon political parties/candidates/PACs — the composer caps at $50 ($100 joint) and denies above $75,000/$150,000 federal AGI"
+}Input schema / properties / orPoliticalPartyCheckoffAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 50: political party $3 checkoff from the refund"
+}Input schema / properties / orPtePaymentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 36: estimated payments from Schedule OR-K-1 line 20 (PTE owner payments via Form OR-19)"
+}Input schema / properties / orRegularExemptionsAdded value: +{
+ "description": "regular exemption count: 'yourself' + 'spouse' credit boxes (6a/6b) + dependents (6c) — $256 each, $0 cliff above $100,000 federal AGI (single/MFS) or $200,000 (others)",
+ "type": "integer"
+}Input schema / properties / orSpouseItemizesAdded value: +{
+ "description": "MFS only: the other spouse itemizes — the Oregon standard deduction becomes $0",
+ "type": "boolean"
+}Input schema / properties / orStateRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 12: OREGON state income tax refund from federal Schedule 1 line 1 (never other states' or local refunds)"
+}Input schema / properties / orStdBoxesAdded value: +{
+ "description": "OR-40 boxes 17a-d: count of 65-or-older (born before January 2, 1961... turned 65 by January 1, 2026) and blind boxes for you/spouse — each adds $1,200 (single/HOH) or $1,000 (other statuses) to the standard deduction",
+ "type": "integer"
+}Input schema / properties / orSubtractionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 13: Schedule OR-ASC line B7 subtractions — including the OBBBA-conforming tips/overtime/passenger-vehicle-interest deductions (codes 390/391/392: Oregon lets you claim the same amounts as federal), US government interest, the federal pension percentage subtraction, OR-HOME first-time home buyer savings, tier 2 Railroad Retirement. Do NOT include Social Security (automatic via taxableSocialSecurity)."
+}Input schema / properties / orTaxMethodOverrideAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OR-40 line 20 alternate-method tax: farm income averaging (OR-FIA-40, box 20a), farm capital gain (Worksheet FCG, box 20b), or the IRREVOCABLE Oregon PTE reduced rate (OR-PTE-FY, box 20c) — agent-computed; wins over the table/chart tax"
+}Input schema / properties / orYoungestUnder3Added value: +{
+ "description": "the youngest dependent was younger than 3 at year end — raises the Oregon EIC from 9% to 12% of the federal EITC (us.or.eic)",
+ "type": "boolean"
+}calculate_tax7 fields changedInput schema / properties / state / properties / alAgiAdded value: +{
+ "description": "Alabama adjusted gross income (Form 40 line 10) — keys the AGI-phased standard deduction chart (us.al.standard_deduction) and the dependent exemption tiers (us.al.dependent_exemption: $1,000 to $50,000, $500 to $100,000, $300 above). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / alDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Alabama dependent count (Form 40 line 14 / Schedule DS) under Alabama's OWN relationship-and-support definition (§ 40-18-19 list + over-50% support; NOT federal § 152) — us.al.dependent_exemption pays $1,000/$500/$300 each by Alabama AGI."
+}Input schema / properties / state / properties / alFederalRefundableCreditsAdded value: +{
+ "description": "The Alabama line 12 worksheet's refundable-credit subtraction: federal EIC (1040 line 27a) + Additional CTC (line 28) + American Opportunity Credit (line 29) + refundable adoption credit (line 30) + Form 2439 credits (Schedule 3 Part II line 13a). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / alFederalTaxPlusNiitAdded value: +{
+ "description": "Federal Form 1040 LINE 22 tax PLUS Form 8960 line 17 Net Investment Income Tax — the gross federal tax for Alabama's unlimited federal income tax deduction worksheet (us.al.federal_tax_deduction). NEVER the W-2 federal withholding. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / alIs65Added value: +{
+ "description": "The person whose Alabama retirement exclusion is being computed was 65 or older — gates the $6,000 Schedule RS exclusion (us.al.retirement_exclusion). Still $6,000 for TY2026 (HB388's $12,000 increase DIED May 2025).",
+ "type": "boolean"
+}Input schema / properties / state / properties / alOvertimePremiumAdded value: +{
+ "description": "One taxpayer's overtime PREMIUM (the amount above the base rate — W-2 Box 12 code TT) for the TY2026-2028 Alabama overtime premium deduction (us.al.overtime_premium_deduction, Act 2026-604, capped $1,000 per taxpayer). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / alTaxableRetirementAdded value: +{
+ "description": "One person's OTHERWISE-TAXABLE Alabama retirement income (IRA/401(k)/SEP/Keogh/403(b) distributions after basis recovery — defined-benefit pensions, Social Security, military, and US/AL government retirement are fully exempt and never enter) for the Schedule RS 65+ exclusion (us.al.retirement_exclusion, up to $6,000). Per person. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return7 fields changedInput schema / properties / state / properties / alAgiAdded value: +{
+ "description": "Alabama adjusted gross income (Form 40 line 10) — keys the AGI-phased standard deduction chart (us.al.standard_deduction) and the dependent exemption tiers (us.al.dependent_exemption: $1,000 to $50,000, $500 to $100,000, $300 above). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / alDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Alabama dependent count (Form 40 line 14 / Schedule DS) under Alabama's OWN relationship-and-support definition (§ 40-18-19 list + over-50% support; NOT federal § 152) — us.al.dependent_exemption pays $1,000/$500/$300 each by Alabama AGI."
+}Input schema / properties / state / properties / alFederalRefundableCreditsAdded value: +{
+ "description": "The Alabama line 12 worksheet's refundable-credit subtraction: federal EIC (1040 line 27a) + Additional CTC (line 28) + American Opportunity Credit (line 29) + refundable adoption credit (line 30) + Form 2439 credits (Schedule 3 Part II line 13a). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / alFederalTaxPlusNiitAdded value: +{
+ "description": "Federal Form 1040 LINE 22 tax PLUS Form 8960 line 17 Net Investment Income Tax — the gross federal tax for Alabama's unlimited federal income tax deduction worksheet (us.al.federal_tax_deduction). NEVER the W-2 federal withholding. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / alIs65Added value: +{
+ "description": "The person whose Alabama retirement exclusion is being computed was 65 or older — gates the $6,000 Schedule RS exclusion (us.al.retirement_exclusion). Still $6,000 for TY2026 (HB388's $12,000 increase DIED May 2025).",
+ "type": "boolean"
+}Input schema / properties / state / properties / alOvertimePremiumAdded value: +{
+ "description": "One taxpayer's overtime PREMIUM (the amount above the base rate — W-2 Box 12 code TT) for the TY2026-2028 Alabama overtime premium deduction (us.al.overtime_premium_deduction, Act 2026-604, capped $1,000 per taxpayer). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / alTaxableRetirementAdded value: +{
+ "description": "One person's OTHERWISE-TAXABLE Alabama retirement income (IRA/401(k)/SEP/Keogh/403(b) distributions after basis recovery — defined-benefit pensions, Social Security, military, and US/AL government retirement are fully exempt and never enter) for the Schedule RS 65+ exclusion (us.al.retirement_exclusion, up to $6,000). Per person. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return20 fields changedInput schema / properties / alAdjustmentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 line 9 / Part II total (per-spouse IRA deduction, Keogh/SEP, early-withdrawal penalty, alimony paid, adoption expenses, MOVING EXPENSES (Alabama kept them), SE health insurance, College Counts 529/PACT, small-employer health premiums, wind/flood retrofit, catastrophe savings, HSA, First/Second-Chance Home Buyer, firefighter insurance, ABLE)"
+}Input schema / properties / alAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 line 33: overpayment applied to 2026 estimated tax"
+}Input schema / properties / alAtpOtherTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule ATP Part I taxes OTHER than the use tax (which uses the shared useTax input): catastrophe-savings recapture (+2.5%), etc."
+}Input schema / properties / alCampaignCheckoffAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 line 20: $1/$2 Alabama Democratic/Republican party checkoffs — these ADD to the tax due (not fund-neutral like the federal checkoff)"
+}Input schema / properties / alDependentsAdded value: +{
+ "description": "Form 40 line 14 dependent count — Alabama's OWN relationship list (§ 40-18-19: child/stepchild/parent/grandparent/sibling/in-laws/blood uncle-aunt-nephew-niece with over-50% support; NOT federal § 152) — $1,000/$500/$300 each by AL AGI (us.al.dependent_exemption); falls back to the shared dependents input",
+ "type": "integer"
+}Input schema / properties / alDonationsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 line 34: Schedule DC donation check-offs total (reduces the refund)"
+}Input schema / properties / alFederalRefundableCreditsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the line 12 worksheet's refundable-credit subtraction: 1040 line 27a EIC + line 28 ACTC + line 29 AOC + line 30 refundable adoption + Schedule 3 Part II line 13a Form 2439 credits"
+}Input schema / properties / alFederalTaxDeductionOverrideAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "OVERRIDE for Form 40 line 12: the RATIOED federal tax for joint-federal/separate-Alabama returns (by each spouse's FAGI share) or part-year residents (AL-AGI/FAGI ratio) — wins over the composer's oracle computation"
+}Input schema / properties / alFederalTaxPlusNiitAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal Form 1040 LINE 22 tax PLUS Form 8960 line 17 NIIT — the line 12 worksheet's gross federal tax (from compute_return, verbatim; NEVER the W-2 federal withholding)"
+}Input schema / properties / alInterestDividendsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 line 6: interest and dividend income (Schedule B attached if over $1,500)"
+}Input schema / properties / alIs65SpouseAdded value: +{
+ "description": "spouse was 65 or older — enables their own $6,000 exclusion",
+ "type": "boolean"
+}Input schema / properties / alIs65YouAdded value: +{
+ "description": "primary taxpayer was 65 or older — enables their $6,000 retirement exclusion (NOTE: still $6,000 for 2026; the reported $12,000 increase was HB388, which died May 2025)",
+ "type": "boolean"
+}Input schema / properties / alItemizedDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Alabama Schedule A total — differs from federal: FICA/Medicare/SE taxes ARE deductible, medical floor is 4% of AGI, NO federal income tax here (it's line 12), NEW 2025 vehicle-loan interest ≤$10,000 phased out $200 per $1,000 ceil-step of AGI over $100,000/$200,000-MFJ. The composer takes the larger of this or the AGI-phased standard deduction."
+}Input schema / properties / alOtherIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 Part I lines 1-3 and 5-7 total EXCLUDING retirement (alimony received, business income/loss, gains — the 1/1/2025+ precious-metal-bullion gain is EXEMPT, rents/royalties/partnerships, farm; negative allowed). Retirement goes in the alTaxableRetirement* fields for the Schedule RS exclusion."
+}Input schema / properties / alPenaltiesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 line 31: Schedule ATP Part II penalties (estimated-tax penalty Form 2210AL etc.) — added to an amount owed, or SUBTRACTED from the refund per the printed line 35 formula"
+}Input schema / properties / alScheduleCpPaymentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 line 26: payments from Schedule CP, Section B line 1 (composite payments)"
+}Input schema / properties / alTaxableRetirementSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "spouse's otherwise-taxable retirement income (Schedule RS Part III)"
+}Input schema / properties / alTaxableRetirementYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "primary taxpayer's OTHERWISE-TAXABLE retirement income (IRA/401(k)/SEP/Keogh/403(b) distributions after basis recovery) — defined-BENEFIT pensions, Social Security, Railroad Retirement, military, and US/AL government retirement are 100% EXEMPT and never entered. The composer applies the 65+ $6,000 Schedule RS exclusion (us.al.retirement_exclusion)."
+}Input schema / properties / alWagesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 40 line 5b: W-2 BOX 16 state wages from ALL states (Schedule W-2 col I+J; Alabama state wages often EXCEED federal Box 1 — deferrals are AL-taxable). Overtime earned Jan 1-Jun 30, 2025 is exempt and already EXCLUDED from Box 16 (W-2 Box 14 'EX OT WAGES'). Falls back to the shared wages input."
+}Input schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn",
- "sc"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc",
+ "al"
+]calculate_tax9 fields changedInput schema / properties / state / properties / scAgiAdded value: +{
+ "description": "Federal adjusted gross income for the TY2026 South Carolina Income Adjusted Deduction phase-out (us.sc.income_adjusted_deduction: reduced by deduction x excess-over-$40,000/$60,000/$80,000 divided by $55,000/$82,500/$110,000, the reduction floored to $10s; H.4216). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scCareChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of qualifying children/dependents for the South Carolina Child and Dependent Care Credit — 2 or more raises the us.sc.cdcc cap from $210 to $420."
+}Input schema / properties / state / properties / scCareExpensesAdded value: +{
+ "description": "Federal Form 2441 child and dependent care EXPENSES (the expense amount, not the federal credit) — us.sc.cdcc pays 7% of it, capped $210/$420 (denied to married filing separately). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "South Carolina dependent count for the exemption being computed (us.sc.dependent_exemption, $4,930 each for 2025): pass the FULL federal dependent count for the SC1040 line w exemption, or the under-age-6 count for the additional line t deduction (evaluate the target once per line)."
+}Input schema / properties / state / properties / scIs65Added value: +{
+ "description": "The person whose South Carolina retirement deduction is being computed was 65 or older by December 31 — raises the us.sc.retirement_deduction cap from $3,000 to $10,000 (and gates the separate $15,000 age-65 deduction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / scLowerQualifiedEarnedIncomeAdded value: +{
+ "description": "The LESSER-earning spouse's South Carolina qualified earned income per the Two Wage Earner Credit worksheet (SC earned income minus the federal adjustments attributable to it) — us.sc.two_wage_earner_credit pays 0.7% of it capped at $50,000 (max $350; married filing jointly only). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scMilitaryRetirementDeductionAdded value: +{
+ "description": "The SAME person's military retirement deduction (SC1040 line p-4/p-5, 100% since TY2022) — the printed worksheet REDUCES the us.sc.retirement_deduction CAP ($3,000/$10,000) by this amount before limiting to qualified retirement income (instructions Example 5). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scQualifiedRetirementIncomeAdded value: +{
+ "description": "One person's qualified retirement income for the South Carolina retirement deduction (401(k)/403(b)/457, IRA, Keogh — EXCLUDING military retirement, which is 100% deducted separately and reduces this deduction) — us.sc.retirement_deduction caps it at $3,000 (under 65) / $10,000 (65+). Per person; evaluate each spouse separately. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scRetirementDeductionsClaimedAdded value: +{
+ "description": "The SAME person's South Carolina retirement deduction (line p-1/p-2) PLUS military retirement deduction (line p-4/p-5) already claimed — us.sc.age65_deduction reduces the $15,000 age-65 deduction by this amount per the printed worksheet. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return9 fields changedInput schema / properties / state / properties / scAgiAdded value: +{
+ "description": "Federal adjusted gross income for the TY2026 South Carolina Income Adjusted Deduction phase-out (us.sc.income_adjusted_deduction: reduced by deduction x excess-over-$40,000/$60,000/$80,000 divided by $55,000/$82,500/$110,000, the reduction floored to $10s; H.4216). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scCareChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of qualifying children/dependents for the South Carolina Child and Dependent Care Credit — 2 or more raises the us.sc.cdcc cap from $210 to $420."
+}Input schema / properties / state / properties / scCareExpensesAdded value: +{
+ "description": "Federal Form 2441 child and dependent care EXPENSES (the expense amount, not the federal credit) — us.sc.cdcc pays 7% of it, capped $210/$420 (denied to married filing separately). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "South Carolina dependent count for the exemption being computed (us.sc.dependent_exemption, $4,930 each for 2025): pass the FULL federal dependent count for the SC1040 line w exemption, or the under-age-6 count for the additional line t deduction (evaluate the target once per line)."
+}Input schema / properties / state / properties / scIs65Added value: +{
+ "description": "The person whose South Carolina retirement deduction is being computed was 65 or older by December 31 — raises the us.sc.retirement_deduction cap from $3,000 to $10,000 (and gates the separate $15,000 age-65 deduction).",
+ "type": "boolean"
+}Input schema / properties / state / properties / scLowerQualifiedEarnedIncomeAdded value: +{
+ "description": "The LESSER-earning spouse's South Carolina qualified earned income per the Two Wage Earner Credit worksheet (SC earned income minus the federal adjustments attributable to it) — us.sc.two_wage_earner_credit pays 0.7% of it capped at $50,000 (max $350; married filing jointly only). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scMilitaryRetirementDeductionAdded value: +{
+ "description": "The SAME person's military retirement deduction (SC1040 line p-4/p-5, 100% since TY2022) — the printed worksheet REDUCES the us.sc.retirement_deduction CAP ($3,000/$10,000) by this amount before limiting to qualified retirement income (instructions Example 5). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scQualifiedRetirementIncomeAdded value: +{
+ "description": "One person's qualified retirement income for the South Carolina retirement deduction (401(k)/403(b)/457, IRA, Keogh — EXCLUDING military retirement, which is 100% deducted separately and reduces this deduction) — us.sc.retirement_deduction caps it at $3,000 (under 65) / $10,000 (65+). Per person; evaluate each spouse separately. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / scRetirementDeductionsClaimedAdded value: +{
+ "description": "The SAME person's South Carolina retirement deduction (line p-1/p-2) PLUS military retirement deduction (line p-4/p-5) already claimed — us.sc.age65_deduction reduces the $15,000 age-65 deduction by this amount per the printed worksheet. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return28 fields changedInput schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi",
- "mn"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn",
+ "sc"
+]Input schema / properties / scActiveTradeTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 8: I-335 flat 3% tax on active trade or business income (agent-computed; the electing income must also appear in scSubtractionsOther as the line l subtraction)"
+}Input schema / properties / scAdditionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 2 total additions (lines a-e: the state income/sales tax deducted in federal itemized deductions MUST be added back on line a; out-of-state rental/business losses; non-SC municipal bond interest; expenses on reserve/subsistence income). CRITICAL for TY2025: SC REJECTED OBBBA conformity (IRC conformity frozen at December 31, 2024) — line e must ADD BACK every OBBBA deduction in federal taxable income (tips exclusion, overtime premium, the $6,000 senior deduction, car-loan interest, OBBBA business items)."
+}Input schema / properties / scAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 27: amount of the line 24 overpayment credited to 2026 estimated tax"
+}Input schema / properties / scCareChildrenAdded value: +{
+ "description": "count of qualifying care children/dependents — 2+ raises the SC CDCC cap from $210 to $420",
+ "type": "integer"
+}Input schema / properties / scCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "federal Form 2441 child/dependent care EXPENSES (not the credit) — SC line 11 pays 7%, max $210/$420 (us.sc.cdcc); DENIED to married filing separately"
+}Input schema / properties / scCatastropheTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 9: tax on excess Catastrophe Savings Account withdrawals"
+}Input schema / properties / scConsumerProtectionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC line u: identity-theft/consumer protection services purchased after a security breach notification — the composer caps at $300 (individual) / $1,000 (joint or with dependents)"
+}Input schema / properties / scContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 28: check-off contributions total (I-330 attached; reduces the refund)"
+}Input schema / properties / scDependentsAdded value: +{
+ "description": "SC line w dependent count (must equal the federal return's) — $4,930 each for 2025 (us.sc.dependent_exemption); falls back to the shared dependents input",
+ "type": "integer"
+}Input schema / properties / scDependentsUnder6Added value: +{
+ "description": "SC line t: dependents under age 6 on December 31 — the SAME $4,930 again each (on top of their line w exemption)",
+ "type": "integer"
+}Input schema / properties / scFederalTaxableIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "REQUIRED for SC: federal Form 1040 line 15 TAXABLE income (from compute_return, verbatim) — the SC1040 line 1 starting point (NOT federal AGI). A NEGATIVE amount is allowed: the composer enters $0 on line 1 and preserves the loss on subtraction line r per the printed instructions."
+}Input schema / properties / scI290PaymentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 19: nonresident real estate withholding paid on Form I-290"
+}Input schema / properties / scIs65SpouseAdded value: +{
+ "description": "spouse was 65 or older by December 31 (lines p-2/q-2)",
+ "type": "boolean"
+}Input schema / properties / scIs65YouAdded value: +{
+ "description": "primary taxpayer was 65 or older by December 31 — raises the retirement cap to $10,000 and enables the $15,000 age-65 deduction (line q-1, reduced by the retirement + military deductions claimed)",
+ "type": "boolean"
+}Input schema / properties / scLatePenaltiesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 32: late filing/late payment penalties and interest"
+}Input schema / properties / scLowerQualifiedEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the LESSER-earning spouse's SC qualified earned income per the Two Wage Earner worksheet (earned income minus attributable federal adjustments) — line 12 credit = 0.7% capped at $50,000 base / $350 credit; MFJ only (us.sc.two_wage_earner_credit)"
+}Input schema / properties / scLumpSumTaxAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 7: tax on lump-sum distribution (SC4972, agent-computed, attached)"
+}Input schema / properties / scMilitaryRetirementSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "spouse's military retirement income (line p-5)"
+}Input schema / properties / scMilitaryRetirementYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "primary taxpayer's military retirement income — 100% deductible since TY2022 (line p-4); per the printed worksheet it REDUCES the same person's retirement-deduction CAP and age-65 deduction (instructions Example 5: $16,000 military at 65+ leaves $0 on lines p-1 and q-1) — the composer handles the interplay"
+}Input schema / properties / scNetLtcgAfterLossesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "net LONG-TERM capital gain held over one year, AFTER netting ALL capital losses (short-term included — the printed example nets an ST loss against the LT gain first) — the composer takes the 44% deduction (line i)"
+}Input schema / properties / scOtherWithholdingAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 20: other SC withholding from 1099s (W-2 amounts go in the shared stateWithholding for line 16)"
+}Input schema / properties / scRetirementIncomeSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "spouse's qualified retirement income for line p-2 (each spouse's own cap; joint returns)"
+}Input schema / properties / scRetirementIncomeYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "primary taxpayer's qualified retirement income (401(k)/403(b)/457, IRA, Keogh — EXCLUDING military retirement, which goes in scMilitaryRetirementYou) — the composer caps at $3,000 under 65 / $10,000 at 65+ (line p-1; us.sc.retirement_deduction)"
+}Input schema / properties / scSubsistenceDaysAdded value: +{
+ "description": "SC line s: days as a full-time federal/state/local law enforcement officer, firefighter, or EMS worker — $16/day subsistence allowance",
+ "type": "integer"
+}Input schema / properties / scSubtractionsOtherAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC subtraction lines f/g/h/j/k/l/m/n/v total (state tax refund, total-and-permanent disability retirement, out-of-state non-personal-service income, volunteer firefighter/EMS/police $6,000 (2025), Future Scholar 529 (unlimited), ACTIVE TRADE OR BUSINESS income electing the I-335 3% flat tax (line l — must pair with scActiveTradeTax), US government interest, nontaxable Guard/Reserve pay, other) — EXCLUDING the composer-computed lines i/o/p/q/r/s/t/u/w"
+}Input schema / properties / scTuitionCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 21: REFUNDABLE tuition tax credit (Form I-319: 50% of qualifying SC-institution tuition within the form's limits — agent-computed with disclosure, form attached)"
+}Input schema / properties / scUnderpaymentPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "SC1040 line 33: underpayment of estimated tax penalty (SC2210 attached)"
+}calculate_tax7 fields changedInput schema / properties / state / descriptionPrevious value: -"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo/us.wi income_tax; parameters via lookup_tax_parameter)"New value: +"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo/us.wi/us.mn income_tax; parameters via lookup_tax_parameter)"Input schema / properties / state / properties / mnAgiAdded value: +{
+ "description": "Federal adjusted gross income (Minnesota Form M1 line 1) — keys the standard-deduction limitation (us.mn.standard_deduction: 3%/10% reduction over $238,950, 80% floor), the dependent-exemption phase-out (us.mn.exemptions), and the Social Security subtraction thresholds (us.mn.social_security_subtraction). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mnDependentEarnedIncomeAdded value: +{
+ "description": "A dependent-claimed filer's earned income for the Minnesota dependent standard-deduction worksheet (deduction = lesser of the table amount or max($1,250, earned + $350)). Only used when isClaimedAsDependent. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mnDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of dependents claimed on Minnesota Schedule M1DQC — $5,200 each for 2025 (us.mn.exemptions, phased 2% per $2,500 ceil-step of AGI over the filing-status threshold)."
+}Input schema / properties / state / properties / mnNetInvestmentIncomeAdded value: +{
+ "description": "Minnesota net investment income per Schedule NIIT (the federal Form 8960 concept minus class 2a agricultural-land gains) — us.mn.niit charges 1% of the amount over $1,000,000 (TY2024+, Minn. Stat. § 290.033). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mnStdBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Minnesota standard-deduction boxes checked (you/spouse 65-or-older — born before January 2, 1961 — and/or blind): each adds $2,000 (single/HOH) or $1,550 (MFJ/QSS/MFS) to the 2025 base (us.mn.standard_deduction)."
+}Input schema / properties / state / properties / mnTaxableSsAdded value: +{
+ "description": "Federally taxable Social Security benefits (Form 1040 line 6b) for the Minnesota Social Security subtraction (us.mn.social_security_subtraction — simplified method; compute the M1M alternative method separately and take the greater when AGI exceeds the full-subtraction threshold). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return7 fields changedInput schema / properties / state / descriptionPrevious value: -"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo/us.wi income_tax; parameters via lookup_tax_parameter)"New value: +"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo/us.wi/us.mn income_tax; parameters via lookup_tax_parameter)"Input schema / properties / state / properties / mnAgiAdded value: +{
+ "description": "Federal adjusted gross income (Minnesota Form M1 line 1) — keys the standard-deduction limitation (us.mn.standard_deduction: 3%/10% reduction over $238,950, 80% floor), the dependent-exemption phase-out (us.mn.exemptions), and the Social Security subtraction thresholds (us.mn.social_security_subtraction). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mnDependentEarnedIncomeAdded value: +{
+ "description": "A dependent-claimed filer's earned income for the Minnesota dependent standard-deduction worksheet (deduction = lesser of the table amount or max($1,250, earned + $350)). Only used when isClaimedAsDependent. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mnDependentsAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of dependents claimed on Minnesota Schedule M1DQC — $5,200 each for 2025 (us.mn.exemptions, phased 2% per $2,500 ceil-step of AGI over the filing-status threshold)."
+}Input schema / properties / state / properties / mnNetInvestmentIncomeAdded value: +{
+ "description": "Minnesota net investment income per Schedule NIIT (the federal Form 8960 concept minus class 2a agricultural-land gains) — us.mn.niit charges 1% of the amount over $1,000,000 (TY2024+, Minn. Stat. § 290.033). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mnStdBoxesAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Count of Minnesota standard-deduction boxes checked (you/spouse 65-or-older — born before January 2, 1961 — and/or blind): each adds $2,000 (single/HOH) or $1,550 (MFJ/QSS/MFS) to the 2025 base (us.mn.standard_deduction)."
+}Input schema / properties / state / properties / mnTaxableSsAdded value: +{
+ "description": "Federally taxable Social Security benefits (Form 1040 line 6b) for the Minnesota Social Security subtraction (us.mn.social_security_subtraction — simplified method; compute the M1M alternative method separately and take the greater when AGI exceeds the full-subtraction threshold). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return19 fields changedInput schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo",
- "wi"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi",
+ "mn"
+]Input schema / properties / mnAdditionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 2: Schedule M1M line 10 + M1MB line 9 additions (non-MN municipal bond interest, federal bonus-depreciation/§ 179 addbacks, positive M1NC adjustments — Minnesota's IRC is frozen at May 1, 2023, so 2025 OBBBA items convert on Schedule M1NC)"
+}Input schema / properties / mnAdvanceCtcRepaymentAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 14b: repayment of 2025 ADVANCE Child Tax Credit payments elected on the 2024 return (reconciliation, NEW for 2025)"
+}Input schema / properties / mnAmtAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 11: Schedule M1MT alternative minimum tax (6.75% broadened base, agent-computed — REQUIRED whenever AMT preference items exist; disclose)"
+}Input schema / properties / mnAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 30: refund applied to 2026 estimated tax"
+}Input schema / properties / mnDependentEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "dependent-claimed filer's earned income for the dependent standard-deduction worksheet (lesser of the table amount or max($1,250, earned + $350))"
+}Input schema / properties / mnDependentsAdded value: +{
+ "description": "dependents on Schedule M1DQC — $5,200 each (2025), phased 2% per $2,500 ceil-step of AGI over $358,550 MFJ/QSS, $239,050 single, $298,800 HOH, $179,275 MFS (gone once the excess passes $122,500/$61,250-MFS); $0 for dependent-claimed filers",
+ "type": "integer"
+}Input schema / properties / mnItemizedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule M1SA Minnesota itemized deductions AFTER M1SA's own 3%/10%/80% limitation — the composer takes the larger of this or the computed standard deduction (MFS: standard barred when the spouse itemizes; pass mnMfsSpouseItemizes)"
+}Input schema / properties / mnMfsSpouseItemizesAdded value: +{
+ "description": "MFS only: the other spouse claims Minnesota itemized deductions — bars the standard deduction (the composer then requires mnItemized)",
+ "type": "boolean"
+}Input schema / properties / mnNetInvestmentIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule NIIT Minnesota net investment income (federal 8960 concept minus class 2a agricultural-land gains) — the composer evaluates us.mn.niit (1% over $1,000,000) into line 14a"
+}Input schema / properties / mnOtherTaxes14aAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 14a: M1HOME/M1529 recapture, M1LS lump-sum tax, and the Schedule NIIT amount if computed outside the composer"
+}Input schema / properties / mnPenaltyInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 28: late-filing/late-payment penalty and interest (agent-computed per the instructions)"
+}Input schema / properties / mnRrTier1OffsetAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Tier 1 Railroad Retirement benefits already subtracted on M1M line 17 — the SS worksheet (steps 25-29) reduces the simplified-method subtraction by this amount (no double subtraction)"
+}Input schema / properties / mnSsAlternativeMethodAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the M1M Worksheet ALTERNATIVE-method Social Security subtraction (steps 9-28, agent-computed, NET of the Tier 1 RR offset) — the composer takes the GREATER of this and the oracle simplified method when AGI exceeds the full-subtraction threshold (2025 alternative maxes: $5,840 MFJ/QSS, $4,560 single/HOH, $2,920 MFS)"
+}Input schema / properties / mnStateRefundAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 6: state income tax refund from federal Schedule 1 line 1 (its own subtraction line)"
+}Input schema / properties / mnStdBoxesAdded value: +{
+ "description": "65-or-older (born before January 2, 1961) and blind boxes for you/spouse — each adds $2,000 (single/HOH) or $1,550 (married statuses) to the standard deduction",
+ "type": "integer"
+}Input schema / properties / mnSubtractionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 7 subtractions (M1M line 40 + M1MB line 22) EXCLUDING the composer-computed Social Security subtraction: U.S. government interest, K-12 education expenses, charitable over $500 for non-itemizers (50% of the excess), bonus-depreciation recovery, M1R age-65+/disabled, M1QPEN public pension, military items, the new 2025 items (coerced debt, consumer enforcement, foreign service, SEIU stipends)"
+}Input schema / properties / mnUnderpaymentPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 27: Schedule M15 underpayment penalty"
+}Input schema / properties / mnWildlifeContributionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "M1 line 18: Nongame Wildlife Fund contribution (reduces the refund)"
+}calculate_tax10 fields changedInput schema / properties / state / descriptionPrevious value: -"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo income_tax; parameters via lookup_tax_parameter)"New value: +"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo/us.wi income_tax; parameters via lookup_tax_parameter)"Input schema / properties / state / properties / wiBothSpouses67Added value: +{
+ "description": "BOTH spouses on a joint Wisconsin return were at least 67 on December 31 — raises the Act 15 retirement subtraction cap from $24,000 to $48,000 regardless of which spouse received the income.",
+ "type": "boolean"
+}Input schema / properties / state / properties / wiFederalEicForWiAdded value: +{
+ "description": "The federal earned income credit AS COMPUTED UNDER WISCONSIN'S IRC (Schedule I Part III recomputation when Part I adjustments exist; otherwise Form 1040 line 27) — the us.wi.eic base. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiIncomeAdded value: +{
+ "description": "Wisconsin income (Form 1 line 7 = federal AGI as adjusted by Schedule I, plus Schedule AD additions, minus Schedule SB subtractions) — drives the sliding standard deduction (us.wi.standard_deduction). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiLowerQualifiedEarnedIncomeAdded value: +{
+ "description": "The LESSER-earning spouse's qualified earned income from Form 1 Schedule 2 line 5 (earned income minus the listed federal Schedule 1 adjustments and any Wisconsin disability exclusion) — us.wi.married_couple_credit takes 3% up to $480. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiPropertyTaxesPaidAdded value: +{
+ "description": "2025 property taxes paid on the principal Wisconsin residence (Form 1 line 16b) — credited at 12% via the printed table; the combined 16a+16b credit caps at $300 ($150 MFS). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of federal-EIC qualifying children for the Wisconsin earned income credit (us.wi.eic: 1 → 4%, 2 → 11%, 3+ → 34% of the federal credit; zero children → no Wisconsin credit)."
+}Input schema / properties / state / properties / wiRentHeatIncludedAdded value: +{
+ "description": "2025 rent paid on the principal Wisconsin residence where HEAT WAS INCLUDED in rent (Form 1 line 16a) — credited at 2.4% via the printed table's $100-row midpoints (us.wi.school_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiRentHeatNotIncludedAdded value: +{
+ "description": "2025 rent paid where heat was NOT included (Form 1 line 16a) — credited at 3.0% via the printed table. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiRetirementIncome67Added value: +{
+ "description": "Federally taxable qualified-plan/IRA retirement income of the 67+ individual(s) NOT already subtracted on Schedule SB lines 12-15 — the NEW 2025 Act 15 subtraction (us.wi.retirement_subtraction_67, $24,000/$48,000 cap). CAUTION: claiming it forfeits every Form 1 credit (lines 13-20, 30-35, Schedule CR). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return10 fields changedInput schema / properties / state / descriptionPrevious value: -"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo income_tax; parameters via lookup_tax_parameter)"New value: +"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo/us.wi income_tax; parameters via lookup_tax_parameter)"Input schema / properties / state / properties / wiBothSpouses67Added value: +{
+ "description": "BOTH spouses on a joint Wisconsin return were at least 67 on December 31 — raises the Act 15 retirement subtraction cap from $24,000 to $48,000 regardless of which spouse received the income.",
+ "type": "boolean"
+}Input schema / properties / state / properties / wiFederalEicForWiAdded value: +{
+ "description": "The federal earned income credit AS COMPUTED UNDER WISCONSIN'S IRC (Schedule I Part III recomputation when Part I adjustments exist; otherwise Form 1040 line 27) — the us.wi.eic base. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiIncomeAdded value: +{
+ "description": "Wisconsin income (Form 1 line 7 = federal AGI as adjusted by Schedule I, plus Schedule AD additions, minus Schedule SB subtractions) — drives the sliding standard deduction (us.wi.standard_deduction). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiLowerQualifiedEarnedIncomeAdded value: +{
+ "description": "The LESSER-earning spouse's qualified earned income from Form 1 Schedule 2 line 5 (earned income minus the listed federal Schedule 1 adjustments and any Wisconsin disability exclusion) — us.wi.married_couple_credit takes 3% up to $480. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiPropertyTaxesPaidAdded value: +{
+ "description": "2025 property taxes paid on the principal Wisconsin residence (Form 1 line 16b) — credited at 12% via the printed table; the combined 16a+16b credit caps at $300 ($150 MFS). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiQualifyingChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of federal-EIC qualifying children for the Wisconsin earned income credit (us.wi.eic: 1 → 4%, 2 → 11%, 3+ → 34% of the federal credit; zero children → no Wisconsin credit)."
+}Input schema / properties / state / properties / wiRentHeatIncludedAdded value: +{
+ "description": "2025 rent paid on the principal Wisconsin residence where HEAT WAS INCLUDED in rent (Form 1 line 16a) — credited at 2.4% via the printed table's $100-row midpoints (us.wi.school_property_tax_credit). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiRentHeatNotIncludedAdded value: +{
+ "description": "2025 rent paid where heat was NOT included (Form 1 line 16a) — credited at 3.0% via the printed table. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / wiRetirementIncome67Added value: +{
+ "description": "Federally taxable qualified-plan/IRA retirement income of the 67+ individual(s) NOT already subtracted on Schedule SB lines 12-15 — the NEW 2025 Act 15 subtraction (us.wi.retirement_subtraction_67, $24,000/$48,000 cap). CAUTION: claiming it forfeits every Form 1 credit (lines 13-20, 30-35, Schedule CR). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return27 fields changedInput schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md",
- "mo"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo",
+ "wi"
+]Input schema / properties / wi2441CreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule WI-2441 line 14 — Wisconsin's additional child and dependent care credit (its own recomputation; transcribe the schedule's result)"
+}Input schema / properties / wiAge65BoxesAdded value: +{
+ "description": "count of 65-or-older boxes (taxpayer/spouse) — $250 each on line 10b (Wisconsin has no blindness exemption; the $700 line 10a exemptions come from the shared `exemptions` count)",
+ "type": "integer"
+}Input schema / properties / wiAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 42: overpayment applied to 2026 estimated tax"
+}Input schema / properties / wiBlindWorkerExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "blind worker transportation services qualifying expenses (Form 1 line 15 credits 50%)"
+}Input schema / properties / wiBothSpouses67Added value: +{
+ "description": "both spouses 67+ on December 31 (joint returns) — raises the SB-16 cap to $48,000",
+ "type": "boolean"
+}Input schema / properties / wiCapitalGainSubtractionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Schedule SB line 5 capital gain/loss subtraction from Schedule WD (30% net long-term gain exclusion, 60% farm assets; capital loss limit $3,000/$1,500-MFS since TY2023; simple mutual-fund/REIT distributions may take 30% directly)"
+}Input schema / properties / wiDependentEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "a dependent-claimed filer's earned income for the Standard Deduction Worksheet for Dependents (deduction = smaller of the table amount or max($1,350, earned + $450))"
+}Input schema / properties / wiDonationsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 24: Schedule 3 fund donations total"
+}Input schema / properties / wiEicQualifyingChildrenAdded value: +{
+ "description": "federal-EIC qualifying children — Wisconsin EIC = 4%/11%/34% of the federal credit for 1/2/3+ children (NO childless credit; MFS ineligible; full-year residents only)",
+ "type": "integer"
+}Input schema / properties / wiFarmlandCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 31: farmland preservation credit (Schedules FC/FC-A, transcribed)"
+}Input schema / properties / wiFederalEicForWiAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the federal EIC AS COMPUTED UNDER WISCONSIN'S IRC (Schedule I Part III recomputation when Part I adjustments exist) — defaults to the shared federalEITC when omitted"
+}Input schema / properties / wiFederalRetirementPenaltiesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the FEDERAL penalties on IRAs/retirement plans/MSAs etc. — Wisconsin charges 33% of them on line 25 ('x .33' printed)"
+}Input schema / properties / wiHomesteadCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 33: homestead credit (Schedule H/H-EZ circuit breaker, agent-computed, refundable)"
+}Input schema / properties / wiItemizedComponentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 Schedule 1 lines 1-4 total: federal Schedule A medical + interest (EXCLUDING out-of-state second homes, boat residences, and U.S.-security carrying interest) + charity + casualty — the composer takes 5% of the excess over the line 8 standard deduction"
+}Input schema / properties / wiLowerQualifiedEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the LESSER-earning spouse's Schedule 2 line 5 qualified earned income (earned income minus the listed federal Schedule 1 adjustments) — married couple credit = 3% up to $480 (joint returns, both spouses employed)"
+}Input schema / properties / wiMarriedHohAdded value: +{
+ "description": "the Form 1 'Head of household, married' checkbox applies — shares the MFS $150 school property tax credit cap",
+ "type": "boolean"
+}Input schema / properties / wiOtherPenaltiesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 26 other penalties (see instructions p.25)"
+}Input schema / properties / wiOtherStateCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 20: net income tax paid to another state (Schedule OS, agent-computed)"
+}Input schema / properties / wiPropertyTaxesPaidAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "property taxes on the principal residence (line 16b; 12% via the printed $25-wide-row table — a different granularity from the $100-row rent tables) — combined 16a+16b credit caps at $300 ($150 MFS or married-HOH); not claimable with the line 34 veterans credit"
+}Input schema / properties / wiRentHeatIncludedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "2025 rent on the principal Wisconsin residence with heat INCLUDED (line 16a; 2.4% via the printed table's $100-row midpoints)"
+}Input schema / properties / wiRentHeatNotIncludedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "rent with heat NOT included (line 16a; 3.0% table)"
+}Input schema / properties / wiRepaymentCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 32: repayment of income previously taxed credit"
+}Input schema / properties / wiRetirement67IncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "qualified-plan/IRA retirement income of the 67+ individual(s) for the NEW 2025 Act 15 subtraction (SB line 16, $24,000/$48,000 cap) — CAUTION: claiming it FORFEITS every credit on lines 13-20, 30-35, and Schedule CR (the composer enforces this); compare both ways before passing"
+}Input schema / properties / wiScheduleIAdjustmentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 2: Schedule I net adjustment (may be negative) converting federal AGI to Wisconsin's IRC — Wisconsin conforms to the Code as of December 31, 2022, so post-2022 federal changes (incl. the 2025 OBBBA) need Schedule I conversion per its instructions"
+}Input schema / properties / wiScheduleUInterestAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 44: Schedule U underpayment interest"
+}Input schema / properties / wiVeteransCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 1 line 34: eligible veterans and surviving spouses property tax credit"
+}calculate_tax7 fields changedInput schema / properties / state / descriptionPrevious value: -"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md income_tax; parameters via lookup_tax_parameter)"New value: +"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo income_tax; parameters via lookup_tax_parameter)"Input schema / properties / state / properties / moBusinessIncomeAdded value: +{
+ "description": "ONE spouse's net business income per the MO-1040 p.16 worksheet (Schedule C/E/F + pass-through business income, losses netted — enter 0 if a combined net loss) — us.mo.business_income_deduction subtracts 20% (R.S.Mo. § 143.022, MO-A Part 1 line 17). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moFederalEicAdded value: +{
+ "description": "Federal earned income credit (Form 1040 line 27a) for the Missouri Working Family Tax Credit (us.mo.wftc = 20% for 2025, nonrefundable; MFS and dependent-claimed filers denied; the printed MO-WFTC question 3 gates investment income at $4,400 — see the rule's form-vs-statute disclosure). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moFederalTaxTotalAdded value: +{
+ "description": "MO-1040 line 11 total federal tax: line 9 (federal 1040 line 22 minus lines 27a/29, minus Schedule 2 Part 1 line 3, minus Schedule 3 Part 2 line 9 — never withholding) plus line 10 other federal tax (Schedule 2 Part 1 line 3; Part 2 lines 8, 14, 15; recapture in 21; Schedule 3 Part 1 line 1). Feeds us.mo.federal_tax_deduction. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moMagiAdded value: +{
+ "description": "COMBINED Missouri adjusted gross income (MO-1040 line 6 = both spouses' line 5 amounts) — keys the federal tax deduction percentage tiers (us.mo.federal_tax_deduction: 35/25/15/5/0%). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moPublicPensionAdded value: +{
+ "description": "ONE spouse's taxable pension from PUBLIC sources (any federal/state/local government pension, federal 1040 line 5b share) for the Missouri public pension exemption (us.mo.public_pension_exemption, MO-A Part 3 Section A: capped at $47,633 for 2025, reduced by that spouse's SS/SSD exemption). Military retirement is a separate 100% subtraction — exclude it here. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moSsSameSpouseExemptionAdded value: +{
+ "description": "The SAME spouse's Social Security / SS Disability exemption from MO-A Part 3 Section C (their taxable SS, exempted 100% when 62+ by December 31 or on SSD) — displaces the public pension exemption dollar-for-dollar (Section A line 3). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_return7 fields changedInput schema / properties / state / descriptionPrevious value: -"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md income_tax; parameters via lookup_tax_parameter)"New value: +"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md/us.mo income_tax; parameters via lookup_tax_parameter)"Input schema / properties / state / properties / moBusinessIncomeAdded value: +{
+ "description": "ONE spouse's net business income per the MO-1040 p.16 worksheet (Schedule C/E/F + pass-through business income, losses netted — enter 0 if a combined net loss) — us.mo.business_income_deduction subtracts 20% (R.S.Mo. § 143.022, MO-A Part 1 line 17). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moFederalEicAdded value: +{
+ "description": "Federal earned income credit (Form 1040 line 27a) for the Missouri Working Family Tax Credit (us.mo.wftc = 20% for 2025, nonrefundable; MFS and dependent-claimed filers denied; the printed MO-WFTC question 3 gates investment income at $4,400 — see the rule's form-vs-statute disclosure). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moFederalTaxTotalAdded value: +{
+ "description": "MO-1040 line 11 total federal tax: line 9 (federal 1040 line 22 minus lines 27a/29, minus Schedule 2 Part 1 line 3, minus Schedule 3 Part 2 line 9 — never withholding) plus line 10 other federal tax (Schedule 2 Part 1 line 3; Part 2 lines 8, 14, 15; recapture in 21; Schedule 3 Part 1 line 1). Feeds us.mo.federal_tax_deduction. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moMagiAdded value: +{
+ "description": "COMBINED Missouri adjusted gross income (MO-1040 line 6 = both spouses' line 5 amounts) — keys the federal tax deduction percentage tiers (us.mo.federal_tax_deduction: 35/25/15/5/0%). May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moPublicPensionAdded value: +{
+ "description": "ONE spouse's taxable pension from PUBLIC sources (any federal/state/local government pension, federal 1040 line 5b share) for the Missouri public pension exemption (us.mo.public_pension_exemption, MO-A Part 3 Section A: capped at $47,633 for 2025, reduced by that spouse's SS/SSD exemption). Military retirement is a separate 100% subtraction — exclude it here. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / moSsSameSpouseExemptionAdded value: +{
+ "description": "The SAME spouse's Social Security / SS Disability exemption from MO-A Part 3 Section C (their taxable SS, exempted 100% when 62+ by December 31 or on SSD) — displaces the public pension exemption dollar-for-dollar (Section A line 3). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}compute_state_return43 fields changedInput schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga",
- "md"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md",
+ "mo"
+]Input schema / properties / mo529DepositAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 52: refund deposited to a Missouri 529 (MOST) account (minimum $25, Form 5632)"
+}Input schema / properties / moActiveDutyMilitaryAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 18: active duty military income deduction (100%, incl. annual training and — NEW 2025 — National Guard/reserve signing bonuses)"
+}Input schema / properties / moAdditionsSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-A Part 1 line 7S: the spouse's additions"
+}Input schema / properties / moAdditionsYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-A Part 1 line 7Y: the primary's additions (non-Missouri state/local bond interest, PTE/NOL addbacks, nonqualified 529/ABLE distributions, food pantry, nonresident property tax)"
+}Input schema / properties / moAppliedToNextYearAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 50: overpayment applied to 2026 estimated tax"
+}Input schema / properties / moBusinessIncomeSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the spouse's net business income for the 20% deduction (17S)"
+}Input schema / properties / moBusinessIncomeYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the primary's MISSOURI-SOURCE net business income per the p.16 worksheet (Schedule C line 31 + Schedule E line 32 + Schedule F/4835 profits, losses netted, MINUS agricultural disaster relief payments already on MO-A line 16; $0 if net loss) — the composer takes the 20% § 143.022 deduction (MO-A line 17Y)"
+}Input schema / properties / moCapitalGainSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the spouse's share of federal capital gains for the 100% subtraction"
+}Input schema / properties / moCapitalGainYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the primary's share of federally reported capital gains (Form 1040 line 7a) — the composer subtracts 100% (MO-A line 18, H.B. 594, NEW for TY2025; a negative amount enters as $0)"
+}Input schema / properties / moEnterpriseZoneSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 28S"
+}Input schema / properties / moEnterpriseZoneYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 28Y: enterprise zone / rural empowerment zone income modification"
+}Input schema / properties / moFagiSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 1S: the spouse's share of federal AGI (combined returns). 1Y + 1S must equal the federal AGI. A NEGATIVE share triggers the 12 CSR 10-2.710 zeroing the composer applies (negative spouse $0, other spouse the netted joint FAGI; both $0 when combined FAGI is negative)."
+}Input schema / properties / moFagiYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 1Y: the PRIMARY taxpayer's share of federal AGI — Missouri combined returns SPLIT total FAGI between spouses per the AGI worksheet (each spouse's own income; joint items allocated). Defaults to the full federalAGI when omitted (one-income couple)."
+}Input schema / properties / moFederalItemizedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-A Part 2 line 1: total federal itemized deductions (federal Schedule A total) plus any approved cultural contributions (literary/musical/scholastic/artistic donations, § 143.141)"
+}Input schema / properties / moFederalTax9Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 9 'Tax from federal return': federal 1040 line 22 MINUS lines 27a and 29, MINUS Schedule 2 Part 1 line 3, MINUS Schedule 3 Part 2 line 9 — never withholding; the EIC must be subtracted"
+}Input schema / properties / moHcsmDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 17: health care sharing ministry contributions not deducted federally"
+}Input schema / properties / moInactiveDutyMilitaryAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 19: inactive duty (drill) military income deduction"
+}Input schema / properties / moItemizingAdded value: +{
+ "description": "taxpayer itemized FEDERALLY and wants Missouri itemized deductions — the composer computes MO-A Part 2 (federal itemized + payroll-tax addback − net state income taxes) and takes the LARGER of that or the standard deduction unless moRequiredToItemize",
+ "type": "boolean"
+}Input schema / properties / moLtcDeductionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 16: qualified long-term care insurance premiums (12+ month policies, net of federally deducted amounts, per the worksheet)"
+}Input schema / properties / moNetStateIncomeTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-A Part 2 line 11: state/local income taxes from Schedule A line 5a MINUS Kansas City/St. Louis earnings taxes (which stay deductible) — or the Part 2 worksheet result when SALT exceeded $40,000/$20,000-MFS or FAGI exceeded $500,000/$250,000-MFS"
+}Input schema / properties / moNrPaymentsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 lines 39+40: MO-2NR/MO-2ENT nonresident partner/entertainer payments"
+}Input schema / properties / moOtherDeductionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 lines 21-24 bucket: beginning farmer, transport facility, foster parent deductions (agent-transcribed)"
+}Input schema / properties / moOtherFederalTax10Added value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 10 'Other federal tax': Schedule 2 Part 1 line 3 + Part 2 lines 8/14/15 + recapture in line 21 + Schedule 3 Part 1 line 1 (attach 4255/8611/8828 for recapture)"
+}Input schema / properties / moOtherTaxesSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 34S"
+}Input schema / properties / moOtherTaxesYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 34Y: 10% of the Federal Form 4972 lump-sum distribution tax, and/or recapture of the low income housing credit (Form 8611) — the printed checkboxes. (Form 4970 trust accumulation amounts are a SUBTRACTION, not a line 34 tax.)"
+}Input schema / properties / moPayrollTaxAddbackAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-A Part 2 lines 2-7 total: the 2025 employee Social Security tax (capped $10,918 per spouse), Railroad Retirement Tier I+II (capped $17,327 per spouse, net of employer refunds), Medicare tax (with Form 8959 adjustments), and self-employment tax (Schedule 2 line 4 − Schedule 1 line 15 + Form 8959 line 13) — Missouri ADDS payroll taxes into itemized deductions"
+}Input schema / properties / moPrivatePensionSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the spouse's private-source pension for Section B"
+}Input schema / properties / moPrivatePensionYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the primary's PRIVATE-source taxable pension/annuity/IRA/401(k) (1040 lines 4b+5b share) — Section B caps each spouse at $6,000 and phases out by income"
+}Input schema / properties / moPropertyTaxCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 43: Form MO-PTS property tax credit (refundable circuit breaker — actual property tax up to $1,100 owners / 20%-of-rent up to $750 renters, from the printed chart; net household income gates $30,000 owners / $27,200 renters; agent-computed from MO-PTS with disclosure)"
+}Input schema / properties / moPublicPensionSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the spouse's public-source pension for their Section A column"
+}Input schema / properties / moPublicPensionYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the primary's PUBLIC-source pension (federal/state/local government, 1040 line 5b share) — the composer runs MO-A Part 3 Section A (min(pension, $47,633) less their Section C exemption). Military retirement goes in moSubtractionsYou instead (100%, MO-A line 10)."
+}Input schema / properties / moRequiredToItemizeAdded value: +{
+ "description": "the filer was REQUIRED to itemize federally (e.g. MFS with an itemizing spouse) — Missouri then requires itemizing even when the standard deduction is larger",
+ "type": "boolean"
+}Input schema / properties / moResidentCreditSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 31S (capped at 30S)"
+}Input schema / properties / moResidentCreditYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 31Y: Form MO-CR credit for taxes paid to other states (agent-computed; the composer caps at line 30Y)"
+}Input schema / properties / moSsExemptSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the spouse's Section C SS/SSD exemption on the same gates"
+}Input schema / properties / moSsExemptYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the primary's MO-A Section C exemption: their TAXABLE Social Security/SSD (1040 line 6b share), 100% exempt — pass ONLY if 62+ by December 31 (the MO-1040 age box) or on Social Security Disability (attested)"
+}Input schema / properties / moStandardDeductionOverrideAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "dependent-claimed filers: the federal DEPENDENT standard deduction limit (greater of $1,350 or earned income + $450, capped at the full amount) — replaces the composer's full standard deduction"
+}Input schema / properties / moSubtractionsSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "the spouse's MO-A subtractions on the same terms"
+}Input schema / properties / moSubtractionsYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-A subtractions for the primary EXCLUDING the composer-computed capital gain (line 18) and business income deduction (line 17): exempt federal-obligation interest, state refund, military retirement (100%), railroad retirement, 529/ABLE contributions ($8,000/taxpayer), qualified health insurance premiums, depreciation adjustments, agriculture disaster relief"
+}Input schema / properties / moTrustFundDonationsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 51: trust fund donations total (51a-51l)"
+}Input schema / properties / moUnderpaymentPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MO-1040 line 55: Form MO-2210 underpayment penalty (90% / 66⅔%-farmer safe harbors)"
+}Input schema / properties / moWftcInvestmentOver4400Added value: +{
+ "description": "Form MO-WFTC question 3: investment income exceeds $4,400 — denies the credit. The MO credit follows EIC law FROZEN as of January 1, 2021 (MO-1040 instructions p.10), so this is the indexed pre-ARPA limit; compute investment income the pre-2021 way (taxable AND tax-exempt interest, dividends, positive net capital gain per the MO-WFTC instructions), NOT the current federal $11,950 gate.",
+ "type": "boolean"
+}calculate_tax12 fields changedInput schema / properties / state / descriptionPrevious value: -"state taxable income for the state tax targets (us.ca/us.va/us.il.income_tax; parameters via lookup_tax_parameter)"New value: +"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md income_tax; parameters via lookup_tax_parameter)"Input schema / properties / state / properties / mdDependentTaxpayerAdded value: +{
+ "description": "Maryland Filing Status 6 — the filer can be claimed as a dependent on another person's return: every Chart 10A exemption is $0 and the poverty level credit is denied (us.md.exemption_amount / us.md.poverty_level_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mdEarnedIncomeAdded value: +{
+ "description": "Earned income for the Maryland poverty level credit (Form 502 line 1b / Worksheet 18B line 2): wages, salaries, tips, other employee compensation plus net self-employment profit — do NOT net farm/business losses. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdExemptionCountAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Maryland exemption COUNT: Form 502 Exemptions areas A (self + spouse) plus C (dependents from Form 502B line 3) — each worth the Chart 10A phased amount via us.md.exemption_amount. Do NOT include the age-65+/blind area-B boxes (those are a separate unphased $1,000 each)."
+}Input schema / properties / state / properties / mdFagiAdded value: +{
+ "description": "Federal adjusted gross income (Maryland Form 502 line 1) — keys the exemption phase-out chart (us.md.exemption_amount), the child tax credit phase-out (us.md.ctc), and the $350,000 Form 502CG surtax gate. May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdFagiPlusAdditionsAdded value: +{
+ "description": "Maryland Form 502 line 7 (federal AGI + Maryland additions) for the poverty level credit gate (Worksheet 18B line 1; MFS filers who filed a joint federal return use the JOINT federal AGI + additions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdHouseholdSizeAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of persons in the family/household from the federal return, for the Maryland poverty income guideline (2025: $15,650 for 1 + $5,500 each additional person — printed-chart exact through 8)."
+}Input schema / properties / state / properties / mdNetCapitalGainSubjectAdded value: +{
+ "description": "Form 502CG line 9 — net capital gain income SUBJECT to Maryland's 2% additional tax (line 1c gain minus the six 502CG exempt classes: primary-residence sale under $1.5M, retirement-plan assets, livestock, easement land, trade-or-business property, nonprofit affordable housing). Only nonzero when federal AGI exceeds $350,000. Feeds us.md.capital_gains_surtax (Form 502 lines 20a/21b). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdQualifiedChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of Maryland CTC qualified children on Form 502B: dependents UNDER 6 at year end, or over 5 and under 17 WITH a disability (assessment attached) — us.md.ctc ($500 each, H.B. 352 phase-out over $15,000 FAGI, gone above $24,000)."
+}Input schema / properties / state / properties / mdQualifyingPensionAdded value: +{
+ "description": "ONE person's qualifying pension/retirement annuity in federal AGI for the Maryland pension exclusion (Worksheet 13A line 1): § 401(a)/403/457(b) employee-retirement-system income only — IRAs (traditional/Roth/rollover), SEP, Keogh, ineligible deferred comp, and foreign retirement income do NOT qualify; the person must be 65+ or totally disabled (or have a totally disabled spouse). Evaluate us.md.pension_exclusion once per qualifying spouse. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdSsRrBenefitsAdded value: +{
+ "description": "The SAME person's TOTAL Social Security and Railroad Retirement benefits (Tier I + Tier II), whether or not federally taxable — Worksheet 13A line 3 reduces the $41,200 maximum dollar-for-dollar. On a joint return count only the pension-receiving spouse's benefits. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdSubdivisionAdded value: +{
+ "description": "Maryland taxing subdivision — the county (or Baltimore City) where the filer resided on the LAST day of the tax year (Form 502 political-subdivision box), driving the us.md.local_tax rate (2025 chart: 2.25%-3.30%; Anne Arundel and Frederick are bracketed/tiered by filing status). Use nonresident for the Tax-Gen. § 10-106.1 special 2.25% nonresident rate.",
+ "enum": [
+ "baltimore_city",
+ "allegany",
+ "anne_arundel",
+ "baltimore_county",
+ "calvert",
+ "caroline",
+ "carroll",
+ "cecil",
+ "charles",
+ "dorchester",
+ "frederick",
+ "garrett",
+ "harford",
+ "howard",
+ "kent",
+ "montgomery",
+ "prince_georges",
+ "queen_annes",
+ "st_marys",
+ "somerset",
+ "talbot",
+ "washington",
+ "wicomico",
+ "worcester",
+ "nonresident"
+ ],
+ "type": "string"
+}compute_return12 fields changedInput schema / properties / state / descriptionPrevious value: -"state taxable income for the state tax targets (us.ca/us.va/us.il.income_tax; parameters via lookup_tax_parameter)"New value: +"state taxable income for the state tax targets (us.ca/us.va/us.il/us.ny/us.oh/us.nc/us.ga/us.md income_tax; parameters via lookup_tax_parameter)"Input schema / properties / state / properties / mdDependentTaxpayerAdded value: +{
+ "description": "Maryland Filing Status 6 — the filer can be claimed as a dependent on another person's return: every Chart 10A exemption is $0 and the poverty level credit is denied (us.md.exemption_amount / us.md.poverty_level_credit).",
+ "type": "boolean"
+}Input schema / properties / state / properties / mdEarnedIncomeAdded value: +{
+ "description": "Earned income for the Maryland poverty level credit (Form 502 line 1b / Worksheet 18B line 2): wages, salaries, tips, other employee compensation plus net self-employment profit — do NOT net farm/business losses. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdExemptionCountAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Maryland exemption COUNT: Form 502 Exemptions areas A (self + spouse) plus C (dependents from Form 502B line 3) — each worth the Chart 10A phased amount via us.md.exemption_amount. Do NOT include the age-65+/blind area-B boxes (those are a separate unphased $1,000 each)."
+}Input schema / properties / state / properties / mdFagiAdded value: +{
+ "description": "Federal adjusted gross income (Maryland Form 502 line 1) — keys the exemption phase-out chart (us.md.exemption_amount), the child tax credit phase-out (us.md.ctc), and the $350,000 Form 502CG surtax gate. May be negative. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdFagiPlusAdditionsAdded value: +{
+ "description": "Maryland Form 502 line 7 (federal AGI + Maryland additions) for the poverty level credit gate (Worksheet 18B line 1; MFS filers who filed a joint federal return use the JOINT federal AGI + additions). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdHouseholdSizeAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of persons in the family/household from the federal return, for the Maryland poverty income guideline (2025: $15,650 for 1 + $5,500 each additional person — printed-chart exact through 8)."
+}Input schema / properties / state / properties / mdNetCapitalGainSubjectAdded value: +{
+ "description": "Form 502CG line 9 — net capital gain income SUBJECT to Maryland's 2% additional tax (line 1c gain minus the six 502CG exempt classes: primary-residence sale under $1.5M, retirement-plan assets, livestock, easement land, trade-or-business property, nonprofit affordable housing). Only nonzero when federal AGI exceeds $350,000. Feeds us.md.capital_gains_surtax (Form 502 lines 20a/21b). In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdQualifiedChildrenAdded value: +{
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "string"
+ }
+ ],
+ "description": "Number of Maryland CTC qualified children on Form 502B: dependents UNDER 6 at year end, or over 5 and under 17 WITH a disability (assessment attached) — us.md.ctc ($500 each, H.B. 352 phase-out over $15,000 FAGI, gone above $24,000)."
+}Input schema / properties / state / properties / mdQualifyingPensionAdded value: +{
+ "description": "ONE person's qualifying pension/retirement annuity in federal AGI for the Maryland pension exclusion (Worksheet 13A line 1): § 401(a)/403/457(b) employee-retirement-system income only — IRAs (traditional/Roth/rollover), SEP, Keogh, ineligible deferred comp, and foreign retirement income do NOT qualify; the person must be 65+ or totally disabled (or have a totally disabled spouse). Evaluate us.md.pension_exclusion once per qualifying spouse. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdSsRrBenefitsAdded value: +{
+ "description": "The SAME person's TOTAL Social Security and Railroad Retirement benefits (Tier I + Tier II), whether or not federally taxable — Worksheet 13A line 3 reduces the $41,200 maximum dollar-for-dollar. On a joint return count only the pension-receiving spouse's benefits. In dollars.",
+ "type": [
+ "number",
+ "string"
+ ]
+}Input schema / properties / state / properties / mdSubdivisionAdded value: +{
+ "description": "Maryland taxing subdivision — the county (or Baltimore City) where the filer resided on the LAST day of the tax year (Form 502 political-subdivision box), driving the us.md.local_tax rate (2025 chart: 2.25%-3.30%; Anne Arundel and Frederick are bracketed/tiered by filing status). Use nonresident for the Tax-Gen. § 10-106.1 special 2.25% nonresident rate.",
+ "enum": [
+ "baltimore_city",
+ "allegany",
+ "anne_arundel",
+ "baltimore_county",
+ "calvert",
+ "caroline",
+ "carroll",
+ "cecil",
+ "charles",
+ "dorchester",
+ "frederick",
+ "garrett",
+ "harford",
+ "howard",
+ "kent",
+ "montgomery",
+ "prince_georges",
+ "queen_annes",
+ "st_marys",
+ "somerset",
+ "talbot",
+ "washington",
+ "wicomico",
+ "worcester",
+ "nonresident"
+ ],
+ "type": "string"
+}compute_state_return26 fields changedInput schema / properties / jurisdiction / enumPrevious value: -[
- "il",
- "va",
- "ca",
- "ny",
- "pa",
- "nj",
- "oh",
- "nc",
- "ga"
-]New value: +[
+ "il",
+ "va",
+ "ca",
+ "ny",
+ "pa",
+ "nj",
+ "oh",
+ "nc",
+ "ga",
+ "md"
+]Input schema / properties / md502crPartBBAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 31: local tax credit from Form 502CR Part BB line 1"
+}Input schema / properties / mdBusinessCreditsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 25: business tax credits (Form 500CR — e-file only; transcribed)"
+}Input schema / properties / mdChildCareExpensesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 9: child and dependent care EXPENSES from federal Form 2441 line 6 — an income subtraction in Maryland (separate from any 502CR Part B credit); the composer caps it at $3,000 ($6,000 when mdChildCareTwoOrMoreDependents)"
+}Input schema / properties / mdChildCareTwoOrMoreDependentsAdded value: +{
+ "description": "two or more care dependents — raises the MD line 9 expense cap from $3,000 to $6,000",
+ "type": "boolean"
+}Input schema / properties / mdContributionsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD lines 35-39: voluntary fund contributions total (reduces the refund)"
+}Input schema / properties / mdCtcChildrenAdded value: +{
+ "description": "Maryland CTC qualified children (dependents under 6, or over 5 and under 17 with a disability) — the composer evaluates us.md.ctc ($500/child, phased out $50 per $1,000 of FAGI over $15,000, $0 above $24,000; refundable via 502CR Part CC into line 45)",
+ "type": "integer"
+}Input schema / properties / mdEarnedIncomeAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 1b earned income (wages + net SE profit, no loss netting) — the poverty level credit base (us.md.poverty_level_credit) and the local poverty credit (19C)"
+}Input schema / properties / mdEicQualifyingChildAdded value: +{
+ "description": "the filer has at least one EIC qualifying child — with married filers this routes line 22 to 50% of the federal EIC (Worksheet 18A) and line 44 to the 45% refundable worksheet (21A); childless single/HOH/QSS filers instead get 100% refundable (18A.1). Also drives the Form 502 EIC checkboxes.",
+ "type": "boolean"
+}Input schema / properties / mdFederalItemizedAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 17a: total federal itemized deductions (federal Schedule A line 17)"
+}Input schema / properties / mdHomebuyerPenaltyAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 51a: first-time homebuyer savings account 10% withdrawal penalty"
+}Input schema / properties / mdHouseholdSizeAdded value: +{
+ "description": "persons in the family/household from the federal return — enables the poverty level credit computation (2025 guideline $15,650 + $5,500 each additional person)",
+ "type": "integer"
+}Input schema / properties / mdInterestChargesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 51: Form 502UP interest / late-filing interest"
+}Input schema / properties / mdItemizedStateLocalTaxesAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 17b: state and local INCOME taxes claimed in the federal Schedule A (plus preservation-easement contributions claimed as a credit) — subtracted from 17a"
+}Input schema / properties / mdItemizingAdded value: +{
+ "description": "taxpayer itemized FEDERALLY and elects Maryland itemized deductions — the composer computes 17a−17b−17c (with the H.B. 352 7.5% phase-out over $200,000/$100,000-MFS FAGI) and still takes the standard deduction if larger (Maryland allows either)",
+ "type": "boolean"
+}Input schema / properties / mdMw506nrsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 42: tax withheld on Form MW506NRS (nonresident real property sale)"
+}Input schema / properties / mdNetCapitalGainSubjectAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Form 502CG line 9: net capital gain subject to the H.B. 352 2% surtax (line 1c gain minus the six exempt classes — primary-residence sale under $1.5M, retirement-plan assets, livestock, easement land, trade-or-business property, nonprofit affordable housing). The composer zeroes it (with a note) unless FAGI exceeds $350,000."
+}Input schema / properties / mdPensionSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "spouse's qualifying pension for their own 13A column (same gates)"
+}Input schema / properties / mdPensionYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "primary taxpayer's qualifying § 401(a)/403/457(b) pension in FAGI for the Worksheet 13A pension exclusion — ONLY if 65+/totally disabled (or spouse totally disabled); IRAs/SEP/Keogh never qualify. The composer evaluates us.md.pension_exclusion per spouse."
+}Input schema / properties / mdRangerPensionAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 10b: Retired Forest/Park/Wildlife Ranger pension exclusion (Worksheet 13E, agent-computed, disclosed)"
+}Input schema / properties / mdRecapturedCreditAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 21a: recaptured credit from Form 502CR Part DD line 1"
+}Input schema / properties / mdSsRrBenefitsSpouseAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "spouse's TOTAL SS/RR benefits for their 13A column"
+}Input schema / properties / mdSsRrBenefitsYouAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "primary taxpayer's TOTAL Social Security + Railroad Retirement benefits (taxable or not) — reduces the $41,200 cap in the primary's 13A column"
+}Input schema / properties / mdStateRefundsAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "MD line 8: taxable state/local income tax refunds included in federal AGI (subtraction)"
+}Input schema / properties / mdSubdivisionAdded value: +{
+ "description": "REQUIRED for MD: the taxing county where the filer resided on the LAST day of the tax year (Form 502 political-subdivision box) — one of baltimore_city, allegany, anne_arundel, baltimore_county, calvert, caroline, carroll, cecil, charles, dorchester, frederick, garrett, harford, howard, kent, montgomery, prince_georges, queen_annes, st_marys, somerset, talbot, washington, wicomico, worcester, nonresident. Drives the mandatory local tax (line 28: flat 2.25%-3.30%; Anne Arundel bracketed with its own printed table; Frederick tiered on the WHOLE income with real cliffs).",
+ "type": "string"
+}Input schema / properties / mdTwoIncomeLesserSpouseNetAdded value: +{
+ "$ref": "#/properties/federalAGI",
+ "description": "Worksheet 13D line 6: the LESSER-income spouse's net Maryland income (their FAGI share + additions share − subtractions share) — the composer caps it at $1,200 for line 14 (joint returns only)"
+}Sourced Italian tax tools for AI agents: cited primary-source search + a deterministic tax engine.
Current source-cited 2026 US tax constants and calculators for AI agents; every answer cites IRS.
US sales tax for AI agents: rates, economic nexus, taxability, filing. Citation-backed.
Machine-readable Japanese crypto-asset tax rules for AI agents: rules-as-code with citations, x402.
Add one secure layer between your agents and this server.
