Headcount run-rate & growth API

Project ending headcount = beginning + hires - separations, with net change, period growth, and annualized growth = (1 + periodGrowth)^(12/periodMonths) - 1. Deterministic workforce-planning math. Answers 'what's our ending headcount','annualized headcount growth','net change after 40 hires and 25 exits'.

Price$0.01per request

MethodPOST

Route/v1/calc/hr-headcount-run-rate

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

hrheadcountgrowthworkforceplanningcalcrun-ratemetrics

API URLhttps://x402.hexl.dev/v1/calc/hr-headcount-run-rate

Integration docs

Example request

{
  "beginningHeadcount": 200,
  "hires": 40,
  "separations": 25
}

Example response

{
  "beginningHeadcount": 200,
  "hires": 40,
  "separations": 25,
  "periodMonths": 12,
  "endingHeadcount": 215,
  "netChange": 15,
  "periodGrowthPercent": 7.5,
  "annualizedGrowthPercent": 7.5
}

Input schema

{
  "type": "object",
  "required": [
    "beginningHeadcount"
  ],
  "properties": {
    "beginningHeadcount": {
      "type": "number",
      "description": "Headcount at the start of the period",
      "examples": [
        200
      ]
    },
    "hires": {
      "type": "number",
      "default": 0,
      "examples": [
        40
      ]
    },
    "separations": {
      "type": "number",
      "default": 0,
      "examples": [
        25
      ]
    },
    "periodMonths": {
      "type": "number",
      "default": 12,
      "examples": [
        12
      ]
    }
  }
}

Output schema

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