Estimate US federal income-tax withholding (Pub 15-T 2026) API

Compute federal income-tax withholding for one pay period using IRS Publication 15-T (2026) Worksheet 1A and the Annual Percentage Method tables. FICA is not included.

The Estimate US federal income-tax withholding (Pub 15-T 2026) operation is part of the Minimum Wage Holiday Calendar API on BRAINIAC.software. Compute federal income-tax withholding for one pay period using IRS Publication 15-T (2026) Worksheet 1A and the Annual Percentage Method tables. FICA is not included. It is exposed as POST /api/v1/labour-tax/us-federal-withholding-estimate and priced at $0.03 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: GOV.UK National Minimum Wage rates US DOL WHD federal minimum wage GOV.UK holiday entitlement guidance IANA Time Zone Database via Intl GOV.UK bank holidays (vendored snapshot, OGL v3.0) and 5 U.S.C. 6103 / US OPM federal holidays HMRC rates and thresholds for employers 2026 to 2027; GOV.UK SSP, maternity pay and income tax rates IRS Publication 15-T (2026) Worksheet 1A and Annual Percentage Method tables Home Office Register of licensed sponsors: workers (vendored CSV, 2026-11-12, OGL v3.0) Limitations: Results are calculations from published tables, not tax, immigration, or employment advice. UK statutory pay and PAYE/NI cover tax year 2026-27 only; PAYE/NI is a constant-pay estimate (no cumulative tables, K codes, student loans or pension). NI categories other than A and M are best-effort. US withholding covers IRS Pub 15-T 2026 only (no nonresident-alien adjustment, no state tables, no FICA); US state minimum wage, LCA/H-1B and state withholding endpoints from issue #83 are not included. Bank holidays cover 2019-2028 (England & Wales, Scotland, Northern Ireland) from the vendored snapshot; US federal holidays are computed for 1971-2100. The sponsor register is a vendored snapshot of current licence holders; NOT_FOUND does not prove a licence was never held. uk-soc2020-search is not yet available (ONS SOC 2020 coding index not vendored). Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Look up UK National Minimum Wage, Look up US federal minimum wage, Calculate UK statutory holiday entitlement, Convert a timestamp between IANA time zones. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.03 USDC
/api/v1/labour-tax/us-federal-withholding-estimate

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/labour-tax/us-federal-withholding-estimate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "taxYear": 2026,
  "wagesThisPeriod": 3000,
  "payFrequency": "biweekly",
  "w4": {
    "formYear": "2020-or-later",
    "filingStatus": "single_or_mfs",
    "step2Checkbox": false
  }
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Minimum Wage Holiday Calendar APIFull docsHow it works