After-tax income breakdown API

Decomposes net (after-tax) income from caller-supplied federal/state/local/FICA/other rates applied to income net of pre-tax deductions, with per-component tax amounts. Answers 'What is my take-home pay?', 'How much goes to each tax?'.

Price$0.04per request

MethodPOST

Route/v1/finance/after-tax-income

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

taxafter-taxnet-incometake-homepayrolleffective-rateaccountingdecomposition

API URLhttps://x402.hexl.dev/v1/finance/after-tax-income

Integration docs

Example request

{
  "grossIncome": 100000,
  "federalRate": 0.22,
  "stateRate": 0.05,
  "ficaRate": 0.0765,
  "preTaxDeductions": 10000
}

Example response

{
  "grossIncome": 100000,
  "preTaxDeductions": 10000,
  "taxableIncome": 90000,
  "components": [
    {
      "label": "federal",
      "rate": 0.22,
      "amount": 19800
    },
    {
      "label": "state",
      "rate": 0.05,
      "amount": 4500
    },
    {
      "label": "fica",
      "rate": 0.0765,
      "amount": 6885
    }
  ],
  "totalTaxRate": 0.3465,
  "totalTaxPercent": 34.65,
  "totalTax": 31185,
  "afterTaxIncome": 58815,
  "takeHomeRatio": 0.5882,
  "interpretation": "34.65% combined rate on taxable income leaves $58815 net (58.82% of gross)."
}

Input schema

{
  "type": "object",
  "required": [
    "grossIncome"
  ],
  "properties": {
    "grossIncome": {
      "type": "number",
      "examples": [
        100000
      ]
    },
    "federalRate": {
      "type": "number",
      "examples": [
        0.22
      ]
    },
    "stateRate": {
      "type": "number",
      "examples": [
        0.05
      ]
    },
    "ficaRate": {
      "type": "number",
      "examples": [
        0.0765
      ]
    },
    "preTaxDeductions": {
      "type": "number",
      "examples": [
        10000
      ]
    }
  }
}

Output schema

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