Utilization & headroom API

Computes resource utilization = busy / total with headroom, over-allocation, a load band, and optional spare capacity in parallel-resource units. Answers 'What percentage of capacity am I using?', 'How much spare capacity do I have?'.

Price$0.02per request

MethodPOST

Route/v1/scheduling/utilization

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

schedulingcapacityutilizationheadroomloadresourceefficiencyagents

API URLhttps://x402.hexl.dev/v1/scheduling/utilization

Integration docs

Example request

{
  "busyTime": 34,
  "totalTime": 40,
  "capacityUnits": 5
}

Example response

{
  "utilization": 0.85,
  "utilizationPercent": 85,
  "headroom": 6,
  "overBy": 0,
  "band": "high",
  "interpretation": "85% utilized (high).",
  "spareCapacityUnits": 0.75
}

Input schema

{
  "type": "object",
  "required": [
    "busyTime",
    "totalTime"
  ],
  "properties": {
    "busyTime": {
      "type": "number",
      "examples": [
        34
      ]
    },
    "totalTime": {
      "type": "number",
      "examples": [
        40
      ]
    },
    "capacityUnits": {
      "type": "number",
      "examples": [
        5
      ]
    }
  }
}

Output schema

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