Employee retention-risk score API

Score flight risk 0-100 via a transparent weighted rubric over five normalized factors: compaRatioGap (0.30), tenureRisk (0.15, peaking ~1.5yr), engagementGap (0.25), managerQualityGap (0.15), and promotionStagnation (0.15), with a low/moderate/high rating and a per-factor contribution breakdown. Answers 'how likely is this employee to leave','what's driving their flight risk','retention risk score for an underpaid 1.5yr employee'.

Price$0.01per request

MethodPOST

Route/v1/calc/hr-retention-risk

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

hrretentionattritionrisk-scoreengagementcalcflight-riskrubric

API URLhttps://x402.hexl.dev/v1/calc/hr-retention-risk

Integration docs

Example request

{
  "compaRatio": 0.85,
  "tenureYears": 1.5,
  "engagementScore": 0.6,
  "managerScore": 0.7,
  "monthsSincePromotion": 18
}

Example response

{
  "retentionRiskScore": 41.5,
  "rating": "moderate",
  "breakdown": [
    {
      "factor": "compaRatioGap",
      "weight": 0.3,
      "riskValue": 0.15,
      "contribution": 4.5
    },
    {
      "factor": "tenureRisk",
      "weight": 0.15,
      "riskValue": 1,
      "contribution": 15
    },
    {
      "factor": "engagementGap",
      "weight": 0.25,
      "riskValue": 0.4,
      "contribution": 10
    },
    {
      "factor": "managerQualityGap",
      "weight": 0.15,
      "riskValue": 0.3,
      "contribution": 4.5
    },
    {
      "factor": "promotionStagnation",
      "weight": 0.15,
      "riskValue": 0.5,
      "contribution": 7.5
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "compaRatio",
    "tenureYears",
    "engagementScore",
    "managerScore",
    "monthsSincePromotion"
  ],
  "properties": {
    "compaRatio": {
      "type": "number",
      "description": "Salary / market midpoint (1.0 = at market)",
      "examples": [
        0.85
      ]
    },
    "tenureYears": {
      "type": "number",
      "description": "Years of tenure",
      "examples": [
        1.5
      ]
    },
    "engagementScore": {
      "type": "number",
      "description": "Engagement score 0-1 (1 = highly engaged)",
      "examples": [
        0.6
      ]
    },
    "managerScore": {
      "type": "number",
      "description": "Manager-quality score 0-1 (1 = excellent)",
      "examples": [
        0.7
      ]
    },
    "monthsSincePromotion": {
      "type": "number",
      "description": "Months since last promotion",
      "examples": [
        18
      ]
    }
  }
}

Output schema

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