TODO_TAGS_REVIEW
TODO_AP2_EXPORT_REVIEW

Gross-to-Net Payroll Calculator (FICA)

Gross-to-net payroll calculation: FICA (Social Security 6.2% up to the OASDI contribution and benefit base for the selected tax year, Medicare 1.45% uncapped, Additional Medicare Tax 0.9% on cumulative wages over $200,000 per IRC 3101(b)(2)), pretax deduction ordering (401(k)/HSA/Section 125 reduce both FICA and federal-taxable wages), and net pay. tax_year is a required input and selects the wage base: $184,500 for 2026 and $176,100 for 2025, with an absent or unsupported year failing closed with error unsupported_or_missing_tax_year rather than defaulting. The Social Security and Medicare rates and the $200,000 Additional Medicare threshold are statutory and not indexed, so they are not year-keyed. federal_withholding_per_period is a declared input, normally fed from art-338-compute-federal-withholding's output at the same tax_year, since kernels cannot import one another. Federal only, not tax advice, state withholding and state payroll taxes out of scope. Consumes art-338-compute-federal-withholding. Not compute_federal_withholding itself, which only computes the federal income tax withholding line.

Tool URL: https://ainumbers.co/chaingraph/art-339-compute-gross-to-net.html

post/v1/tools/compute_gross_to_net

Request

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

Request body

federal_withholding_per_periodnumber
gross_wages_per_periodnumber
post_tax_other_deductionsnumber
pretax_reduces_fica_and_fitnumber
tax_yearunknown required
ytd_fica_wages_before_periodnumber

Response

Successful tool execution result

additional_medicare_taxinteger
additional_medicare_thresholdinteger
additional_medicare_wages_this_periodinteger
constants_versionstring
errorstring
federal_withholding_per_periodinteger
fica_tax_totalnumber
fica_wages_this_periodinteger
medicare_taxnumber
net_paynumber
notestring
post_tax_other_deductionsinteger
pretax_reduces_fica_and_fitinteger
regulatory_basisstring
social_security_taxinteger
ss_taxable_wages_this_periodinteger
ss_wage_baseinteger
supported_tax_yearsstring[]
tax_yearstring
ytd_fica_wages_after_periodinteger

Changes

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