Payroll gross-up calculator API

Gross-up the payment needed so an employee nets a target after a flat tax rate using gross = net / (1 - rate), returning tax withheld and the gross-up factor. The standard relocation/bonus gross-up formula. Answers 'what gross gives a $5000 net at 31.69%','gross-up a net bonus','how much to pay so they keep $X'.

Price$0.01per request

MethodPOST

Route/v1/calc/hr-gross-up

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

hrpayrollgross-uptaxbonuscalcnetwithholding

API URLhttps://x402.hexl.dev/v1/calc/hr-gross-up

Integration docs

Example request

{
  "netTarget": 5000,
  "taxRate": 0.3169
}

Example response

{
  "netTarget": 5000,
  "taxRate": 0.3169,
  "grossAmount": 7319.57,
  "taxWithheld": 2319.57,
  "grossUpFactor": 1.463915
}

Input schema

{
  "type": "object",
  "required": [
    "netTarget",
    "taxRate"
  ],
  "properties": {
    "netTarget": {
      "type": "number",
      "description": "Desired net amount in dollars",
      "examples": [
        5000
      ]
    },
    "taxRate": {
      "type": "number",
      "description": "Flat tax rate as a decimal < 1",
      "examples": [
        0.3169
      ]
    }
  }
}

Output schema

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