Compa-ratio calculator API

Compute compa-ratio = salary / range midpoint (midpoint = (min+max)/2 when not given), classifying below/within/above range and reporting range penetration when min/max are supplied. Deterministic comp-analysis math. Answers 'what's my compa-ratio','am I paid below midpoint','range penetration for $95k in an $80k-$120k band'.

Price$0.01per request

MethodPOST

Route/v1/calc/hr-compa-ratio

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

hrcompensationcompa-ratiopay-equitysalarycalcrangemidpoint

API URLhttps://x402.hexl.dev/v1/calc/hr-compa-ratio

Integration docs

Example request

{
  "salary": 95000,
  "rangeMin": 80000,
  "rangeMax": 120000
}

Example response

{
  "salary": 95000,
  "rangeMidpoint": 100000,
  "compaRatio": 0.95,
  "compaRatioPercent": 95,
  "position": "within range",
  "rangePenetration": 37.5
}

Input schema

{
  "type": "object",
  "required": [
    "salary"
  ],
  "properties": {
    "salary": {
      "type": "number",
      "description": "Employee salary in dollars",
      "examples": [
        95000
      ]
    },
    "rangeMidpoint": {
      "type": "number",
      "description": "Pay-range midpoint (or supply rangeMin + rangeMax)",
      "examples": [
        100000
      ]
    },
    "rangeMin": {
      "type": "number",
      "examples": [
        80000
      ]
    },
    "rangeMax": {
      "type": "number",
      "examples": [
        120000
      ]
    }
  }
}

Output schema

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