Tax

Room to the top of each tax bracket

Reports how much more ordinary income fits before crossing into each higher federal bracket (room to the top of the current and each higher bracket), plus the room remaining in the 0% and 15% long-term capital gains brackets. Powers bracket-fill decisions (Roth conversions, withdrawal sequencing, gain harvesting). Uses the year-keyed federal tables. Deterministic.

post/v1/tax/bracket-room

Request

  • Base URL: https://api.numeratica.com
  • URL: https://api.numeratica.com/v1/tax/bracket-room
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

tax_yearinteger required

Supported: 2025, 2026.

filing_status'single' | 'mfj' | 'mfs' | 'hoh' required
taxable_incomenumber required

Ordinary taxable income (after deductions).

Example request

{
  "tax_year": 2026,
  "taxable_income": 120000
}

Response

Bracket room

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "bracket_1a2b3c4d5e6f7a8b",
  "engine_version": "bracket-room-1.0.0",
  "inputs": {
    "tax_year": 2026,
    "taxable_income": 120000
  },
  "result": {
    "marginal_rate": 0.22
  }
}

Changes

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