Total compensation calculator API

Sum total comp = base + bonus + annualized equity (equityValue/vestingYears) + benefits + retirement match, returning cash comp, base-as-percent-of-total, and a per-component breakdown. A transparent TC model for offer comparison. Answers 'what's my total comp','annualize my equity grant','cash vs total compensation'.

Price$0.01per request

MethodPOST

Route/v1/calc/hr-total-comp

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

hrcompensationtotal-compequitybenefitscalcofferpackage

API URLhttps://x402.hexl.dev/v1/calc/hr-total-comp

Integration docs

Example request

{
  "baseSalary": 150000,
  "bonus": 20000,
  "equityValue": 200000,
  "vestingYears": 4,
  "benefitsValue": 15000,
  "retirementMatch": 6000
}

Example response

{
  "baseSalary": 150000,
  "bonus": 20000,
  "annualEquity": 50000,
  "benefitsValue": 15000,
  "retirementMatch": 6000,
  "totalCompensation": 241000,
  "cashCompensation": 170000,
  "basePercentOfTotal": 62.24,
  "breakdown": [
    {
      "component": "base",
      "value": 150000
    },
    {
      "component": "bonus",
      "value": 20000
    },
    {
      "component": "equity (annualized)",
      "value": 50000
    },
    {
      "component": "benefits",
      "value": 15000
    },
    {
      "component": "retirementMatch",
      "value": 6000
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "baseSalary"
  ],
  "properties": {
    "baseSalary": {
      "type": "number",
      "description": "Annual base salary in dollars",
      "examples": [
        150000
      ]
    },
    "bonus": {
      "type": "number",
      "default": 0,
      "examples": [
        20000
      ]
    },
    "equityValue": {
      "type": "number",
      "description": "Total equity grant value in dollars",
      "default": 0,
      "examples": [
        200000
      ]
    },
    "vestingYears": {
      "type": "number",
      "default": 4,
      "examples": [
        4
      ]
    },
    "benefitsValue": {
      "type": "number",
      "default": 0,
      "examples": [
        15000
      ]
    },
    "retirementMatch": {
      "type": "number",
      "default": 0,
      "examples": [
        6000
      ]
    }
  }
}

Output schema

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