---
title: "Get Factory Utilization"
method: GET
path: "/api/v1/factory/utilization"
tags: ["factory"]
---

# Get Factory Utilization

`GET /api/v1/factory/utilization`

## Request

- Base URL: `https://api.primeintellect.ai`
- URL: `https://api.primeintellect.ai/api/v1/factory/utilization`
- Auth: HTTP bearer

The team's Model Factory utilization curve: Slurm node
allocated/idle counts per bucket, derived from the slurmdbd
accounting record with the live jobs read as the truth for the
current bucket. Per-source freshness travels in `sources`; gaps
are gaps, never zero-filled.

## Query parameters

- `team_id` string, required: Team whose Model Factory fleet to read
- `window` '1h' | '24h' | '7d' | '30d' | '90d': Curve window; bucket sizes scale with the window (1h->1min, 24h->5min, 7d->hourly, 30d->3h, 90d->daily)

## Response `200`

Successful Response

- FactoryUtilizationResponse: Envelope for the cluster utilization curve (public + internal routes).
  - `schema_version` 1
  - `as_of` string, date-time, required
  - `window` '1h' | '24h' | '7d' | '30d' | '90d', required
  - `bucket_seconds` integer, required
  - `clusters` FactoryClusterUtilization[], required
    - `display_name` string, required
    - `status` 'online' | 'offline', required
    - `total_nodes` integer, nullable
    - `derived_from` 'accounting'
    - `series` FactoryNodeUtilizationPoint[]
      - `timestamp` string, date-time, required
      - `allocated` integer, nullable
      - `idle` integer, nullable
      - `draining` integer, nullable
    - `source` FactorySourceStatus: Freshness/coverage entry for one evidence source. EXACTLY these three keys. No source id, adapter detail, endpoint or raw error may ever be added here.
      - `kind` 'capacity' | 'training' | 'inference' | 'slurm', required
      - `status` 'ok' | 'stale' | 'error', required
      - `observed_at` string, date-time, nullable

## Other responses

- `401`: Authorization failed
- `422`: Invalid request data

## Changes

> 49 revisions in range; 1 not diffed.

- **2026-10-12** `8537b45307ec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/primeintellect/apis/pi-api/changes/api/v1/factory/utilization/get.md)

---

[API](https://skmtc.dev/primeintellect/apis/pi-api.md) - [All operations](https://skmtc.dev/primeintellect/apis/pi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/primeintellect/apis/pi-api/revisions/7f032a9306b0?raw)