# x402toll Bonus & Commission Tax Withholding Calculator

> x402toll Bonus & Commission Tax Withholding Calculator is a paid API for AI agents from x402toll.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Calculates federal supplemental-wage withholding (22% flat or 37% over $1M), FICA, and optional state tax on a bonus or commission to show net take-home pay.

## Facts

- Endpoint: POST https://x402toll.com/v1/tax/bonus
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402toll-bonus-commission-tax-withholding-calculator-f04aca67
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wDhvmpldbShiveYIrlbN2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402toll-bonus-commission-tax-withholding-calculator-f04aca67 -d '<json body>'
```

Example prompt: I'm getting a $45,000 year-end bonus and I've already received $80,000 in supplemental wages this year — can you calculate my federal withholding, FICA, and net take-home, and also apply my state's 5% supplemental rate?

## When to prefer this

Use this endpoint when you need a quick, rule-based calculation of bonus or commission withholding using the IRS supplemental wage flat rate (22% / 37%) rather than the aggregate method. Ideal for payroll estimation, offer-letter modeling, or financial planning when the employee's regular wages are unknown. Prefer this over a full W-4 aggregate calculator when you only have the bonus amount and YTD supplemental wages.

## Known failure modes

- bonusAmount exceeds maximum (1,000,000,000) — validation error
- bonusAmount is negative — validation error
- stateSupplementalRatePct outside valid percentage range — validation error
- Missing required bonusAmount field — 400 Bad Request
- Payment not included or insufficient — 402 Payment Required

## How this service works

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.

## Output

Returns a breakdown of federal supplemental-wage withholding (22% flat or 37% for wages over $1M cumulative), Social Security and Medicare (FICA) withholding, state supplemental withholding if a rate was provided, and the final net take-home dollar amount after all deductions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bonusAmount": {
   "type": "number",
   "maximum": 1000000000,
   "minimum": 0
  },
  "ytdSupplementalWages": {
   "type": "number",
   "default": 0
  },
  "subjectToSocialSecurity": {
   "type": "boolean",
   "default": true
  },
  "stateSupplementalRatePct": {
   "type": "number",
   "default": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402toll-bonus-commission-tax-withholding-calculator-f04aca67/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402toll.com](https://www.zero.xyz/host/x402toll.com/llms.txt)