> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primeintellect.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Factory Status

> 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.



## OpenAPI

````yaml https://api.primeintellect.ai/openapi.json get /api/v1/factory/status
openapi: 3.1.0
info:
  title: PI API
  version: 0.1.0
servers:
  - url: https://api.primeintellect.ai
security: []
paths:
  /api/v1/factory/status:
    get:
      tags:
        - factory
      summary: Get Factory Status
      description: |-
        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.
      operationId: get_factory_status_api_v1_factory_status_get
      parameters:
        - name: team_id
          in: query
          required: true
          schema:
            type: string
            description: Team whose Model Factory fleet to read
            title: Team Id
          description: Team whose Model Factory fleet to read
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FactoryStatusResponse'
        '401':
          description: Authorization failed
        '422':
          description: Invalid request data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    FactoryStatusResponse:
      properties:
        schema_version:
          type: integer
          enum:
            - 1
          const: 1
          title: Schema Version
          default: 1
        as_of:
          type: string
          format: date-time
          title: As Of
        clusters:
          items:
            $ref: '#/components/schemas/FactoryClusterStatus'
          type: array
          title: Clusters
      additionalProperties: false
      type: object
      required:
        - as_of
        - clusters
      title: FactoryStatusResponse
    ErrorResponse:
      properties:
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
          title: Errors
      type: object
      required:
        - errors
      title: ErrorResponse
    FactoryClusterStatus:
      properties:
        display_name:
          type: string
          title: Display Name
        gpu_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Gpu Type
        total_gpus:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Gpus
        status:
          type: string
          enum:
            - online
            - offline
          title: Status
        unassigned_gpus:
          anyOf:
            - type: integer
            - type: 'null'
          title: Unassigned Gpus
        unknown_gpus:
          anyOf:
            - type: integer
            - type: 'null'
          title: Unknown Gpus
        allocations:
          items:
            $ref: '#/components/schemas/FactoryPoolStatus'
          type: array
          title: Allocations
        sources:
          items:
            $ref: '#/components/schemas/FactorySourceStatus'
          type: array
          title: Sources
      additionalProperties: false
      type: object
      required:
        - display_name
        - status
        - allocations
        - sources
      title: FactoryClusterStatus
    ErrorDetail:
      properties:
        param:
          type: string
          title: Param
        details:
          type: string
          title: Details
      type: object
      required:
        - param
        - details
      title: ErrorDetail
    FactoryPoolStatus:
      properties:
        type:
          type: string
          enum:
            - training
            - inference
            - slurm
          title: Type
        reserved_gpus:
          anyOf:
            - type: integer
            - type: 'null'
          title: Reserved Gpus
        in_use_gpus:
          anyOf:
            - type: integer
            - type: 'null'
          title: In Use Gpus
        idle_inside_gpus:
          anyOf:
            - type: integer
            - type: 'null'
          title: Idle Inside Gpus
        unknown_gpus:
          anyOf:
            - type: integer
            - type: 'null'
          title: Unknown Gpus
      additionalProperties: false
      type: object
      required:
        - type
      title: FactoryPoolStatus
      description: |-
        One pool's GPU allocation summary.

        `unknown_gpus` is how much of a known reservation could not be
        classified, NOT free capacity. `None` means "no usable evidence for
        this field" — the response must never substitute 0 to look tidy.
    FactorySourceStatus:
      properties:
        kind:
          type: string
          enum:
            - capacity
            - training
            - inference
            - slurm
          title: Kind
        status:
          type: string
          enum:
            - ok
            - stale
            - error
          title: Status
        observed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Observed At
      additionalProperties: false
      type: object
      required:
        - kind
        - status
      title: FactorySourceStatus
      description: |-
        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.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.