Take-home (net) pay estimator API

Estimate net pay as taxable = gross - preTaxDeductions, then net = taxable - (effectiveTaxRate x taxable) - postTaxDeductions, returning the take-home ratio and optional annualized figures. A transparent net-pay model. Answers 'what's my take-home on $5000 gross','net pay after 22% tax and 401k','how much hits my bank account'.

Price$0.01per request

MethodPOST

Route/v1/calc/hr-take-home-pay

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

hrpayrollnet-paytake-hometaxcalcdeductionspaycheck

API URLhttps://x402.hexl.dev/v1/calc/hr-take-home-pay

Integration docs

Example request

{
  "grossPay": 5000,
  "effectiveTaxRate": 0.22,
  "preTaxDeductions": 500,
  "postTaxDeductions": 200
}

Example response

{
  "grossPay": 5000,
  "preTaxDeductions": 500,
  "taxableIncome": 4500,
  "effectiveTaxRate": 0.22,
  "estimatedTax": 990,
  "postTaxDeductions": 200,
  "netPay": 3310,
  "takeHomeRatio": 0.662
}

Input schema

{
  "type": "object",
  "required": [
    "grossPay",
    "effectiveTaxRate"
  ],
  "properties": {
    "grossPay": {
      "type": "number",
      "description": "Gross pay per period in dollars",
      "examples": [
        5000
      ]
    },
    "effectiveTaxRate": {
      "type": "number",
      "description": "Blended tax rate as a decimal 0-1 (federal+state+FICA)",
      "examples": [
        0.22
      ]
    },
    "preTaxDeductions": {
      "type": "number",
      "default": 0,
      "examples": [
        500
      ]
    },
    "postTaxDeductions": {
      "type": "number",
      "default": 0,
      "examples": [
        200
      ]
    },
    "payPeriodsPerYear": {
      "type": "number",
      "examples": [
        26
      ]
    }
  }
}

Output schema

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