---
title: "Withholding and net take-home on a bonus/commission using the 2026 federal supplemental-wage rate (22% flat; 37% on cumulative supplemental wages over $1M), plus FICA and an optional state supplemental rate."
method: POST
path: "/v1/tax/bonus"
tags: ["Payroll & tax"]
---

# Withholding and net take-home on a bonus/commission using the 2026 federal supplemental-wage rate (22% flat; 37% on cumulative supplemental wages over $1M), plus FICA and an optional state supplemental rate.

`POST /v1/tax/bonus`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/v1/tax/bonus`
- Auth: none declared

Withholding and net take-home on a bonus/commission using the 2026 federal supplemental-wage rate (22% flat; 37% on cumulative supplemental wages over $1M), plus FICA and an optional state supplemental rate.

Payment: x402 ($0.05 USDC on eip155:8453). Call unpaid to receive an HTTP 402 with requirements, then retry with the PAYMENT-SIGNATURE header. Method: federal = 22% up to $1M cumulative supplemental, 37% above; SS 6.2% (if subject) + Medicare 1.45% + optional state supplemental; net = bonus - all withholding

## Request body

- object
  - `bonusAmount` number, required
  - `ytdSupplementalWages` number
  - `stateSupplementalRatePct` number
  - `subjectToSocialSecurity` boolean

## Response `200`

Verified result + provenance (formula, sources, reproducible SHA-256 hash).

## Other responses

- `400`: Invalid input (no charge) — body echoes the JSON Schema.
- `402`: Payment required — PAYMENT-REQUIRED header carries the x402 accepts[] quote.

---

[API](https://skmtc.dev/x402toll/apis/tollbooth-verified-calculators-for-ai-agents.md) · [All operations](https://skmtc.dev/x402toll/apis/tollbooth-verified-calculators-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/x402toll/apis/tollbooth-verified-calculators-for-ai-agents/revisions/60cb70a3e1a5?raw)