Resource utilization rate API

Compute the staffing KPI utilization = billableHours / availableHours with percent, gap to target, idle hours, and a bucket (over-allocated >100%, optimal 70-90%, under-utilized <60%). Answers 'what is my resource utilization','am I over- or under-allocated','how many idle hours','utilization vs target'.

Price$0.01per request

MethodPOST

Route/v1/calc/pm-resource-utilization

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcpmresourceutilizationstaffingallocationcapacitykpi

API URLhttps://x402.hexl.dev/v1/calc/pm-resource-utilization

Integration docs

Example request

{
  "billableHours": 32,
  "availableHours": 40
}

Example response

{
  "billableHours": 32,
  "availableHours": 40,
  "utilization": 0.8,
  "utilizationPct": 80,
  "targetUtilization": 0.8,
  "gapToTargetPct": 0,
  "bucket": "optimal",
  "idleHours": 8,
  "formula": "utilization = billableHours / availableHours"
}

Input schema

{
  "type": "object",
  "required": [
    "billableHours",
    "availableHours"
  ],
  "properties": {
    "billableHours": {
      "type": "number",
      "description": "Hours on billable/project work",
      "examples": [
        32
      ]
    },
    "availableHours": {
      "type": "number",
      "description": "Total available capacity hours",
      "examples": [
        40
      ]
    },
    "targetUtilization": {
      "type": "number",
      "description": "Target rate 0-1",
      "default": 0.8,
      "examples": [
        0.8
      ]
    }
  }
}

Output schema

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