Tax-bracket headroom API

Compute how much more ordinary income fits before the next US 2024 federal bracket, returning the current bracket rate, the bracket top, and the dollar headroom remaining. Useful for Roth-conversion and income-timing decisions. Answers 'how much more can I earn before the next bracket','room left in my 22% bracket','top of my tax bracket','income headroom for a Roth conversion'.

Price$0.01per request

MethodPOST

Route/v1/calc/tax-bracket-headroom

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

taxbracket-headroombracketsroth-conversionincome-timingmarginaluscalc

API URLhttps://x402.hexl.dev/v1/calc/tax-bracket-headroom

Integration docs

Example request

{
  "taxableIncome": 50000,
  "filingStatus": "single"
}

Example response

{
  "year": 2024,
  "filingStatus": "single",
  "taxableIncome": 50000,
  "currentBracketRate": 0.22,
  "currentBracketPercent": 22,
  "bracketTop": 100525,
  "headroomToNextBracket": 50525,
  "interpretation": "You can earn $50525 more before the next bracket above 22%.",
  "note": "Estimate. US federal 2024 ordinary brackets on taxable income."
}

Input schema

{
  "type": "object",
  "required": [
    "taxableIncome"
  ],
  "properties": {
    "taxableIncome": {
      "type": "number",
      "description": "Taxable income in USD",
      "examples": [
        50000
      ]
    },
    "filingStatus": {
      "type": "string",
      "enum": [
        "single",
        "married",
        "head"
      ],
      "examples": [
        "single"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}