TODO_TAGS_REVIEW
TODO_AP2_EXPORT_REVIEW

Federal Withholding Calculator (Percentage Method)

Federal income tax withholding via the IRS Publication 15-T percentage method, Worksheet 1A, for a 2020-or-later Form W-4. tax_year is a required input and selects the edition: the 2026 Section 1 and 2025 Section 4 STANDARD Withholding Rate Schedules are both carried, and an absent or unsupported year fails closed with error unsupported_or_missing_tax_year rather than defaulting to an edition the caller never chose. Supports single/MFS, married filing jointly, and head of household, plus Step 3 dependents credit, Step 4(a) other income, Step 4(b) deductions, and Step 4(c) extra withholding. STANDARD Withholding Rate Schedules only; the Form W-4 Step 2 multiple-jobs checkbox table is out of scope. Federal only, not tax advice, state withholding out of scope. Feeds art-339-compute-gross-to-net as its federal_withholding_per_period input, which must be called with the same tax_year. Not compute_gross_to_net itself, which computes FICA and net pay.

Tool URL: https://ainumbers.co/chaingraph/art-338-compute-federal-withholding.html

post/v1/tools/compute_federal_withholding

Request

  • Base URL: https://ainumbers.co
  • URL: https://ainumbers.co/v1/tools/compute_federal_withholding
  • Auth: none declared

Request body

filing_statusunknown required
gross_wages_per_periodnumber
pay_frequencyunknown required
step3_dependents_credit_annualnumber
step4a_other_income_annualnumber
step4b_deductions_annualnumber
step4c_extra_withholding_per_periodnumber
tax_yearunknown required

Response

Successful tool execution result

adjusted_annual_wage_amountinteger
bracket_at_leastinteger
bracket_ratenumber
constants_versionstring
errorstring
federal_withholding_per_periodnumber
filing_statusstring
notestring
pay_frequencystring
periods_per_yearinteger
regulatory_basisstring
step3_credit_this_periodinteger
step4c_extra_withholding_per_periodinteger
supported_tax_yearsstring[]
tax_yearstring
tentative_annual_withholdinginteger
tentative_withholding_this_periodnumber

Changes

No recorded changes to this operation across all 1 revision of this API.