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

# Get Factory Status

`GET /api/v1/factory/status`

## Request

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

Fleet status for the caller's team: cluster capacity split into
training / inference / slurm allocations with reserved, in-use,
idle-inside, unassigned and unknown GPU counts plus per-source
freshness.

The selected `team_id` must be a team the token's user is a member
of; data of other teams is never returned.

## Query parameters

- `team_id` string, required: Team whose Model Factory fleet to read

## Response `200`

Successful Response

- FactoryStatusResponse
  - `schema_version` 1
  - `as_of` string, date-time, required
  - `clusters` FactoryClusterStatus[], required
    - `display_name` string, required
    - `gpu_type` string, nullable
    - `total_gpus` integer, nullable
    - `status` 'online' | 'offline', required
    - `unassigned_gpus` integer, nullable
    - `unknown_gpus` integer, nullable
    - `allocations` FactoryPoolStatus[], required
      - `type` 'training' | 'inference' | 'slurm', required
      - `reserved_gpus` integer, nullable
      - `in_use_gpus` integer, nullable
      - `idle_inside_gpus` integer, nullable
      - `unknown_gpus` integer, nullable
    - `sources` FactorySourceStatus[], required
      - `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-11** `9062b670646d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/primeintellect/apis/pi-api/changes/api/v1/factory/status/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)