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

# Get Managed Runner Stats

> Retrieve system statistics and information for a managed runner

## Overview

Fetch real-time system statistics from a managed ComfyUI runner, including hardware information, resource usage, installed extensions, and configuration settings.

<Info>
  Access to managed runners requires a **Pro** or **Plus** tier subscription.
</Info>

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier (UUID) of the managed runner to query.
</ParamField>

## Response

<ResponseField name="system" type="object" required>
  System information.
</ResponseField>

<ResponseField name="system.os" type="string">
  Operating system name.
</ResponseField>

<ResponseField name="system.ram_free" type="integer">
  Free RAM in bytes.
</ResponseField>

<ResponseField name="system.ram_total" type="integer">
  Total RAM in bytes.
</ResponseField>

<ResponseField name="system.comfyui_version" type="string">
  ComfyUI version number.
</ResponseField>

<ResponseField name="system.python_version" type="string">
  Python version running ComfyUI.
</ResponseField>

<ResponseField name="devices" type="array" required>
  Array of compute devices (GPUs/CPUs) available to ComfyUI.
</ResponseField>

<ResponseField name="devices[].name" type="string">
  Device name/model.
</ResponseField>

<ResponseField name="devices[].type" type="string">
  Device type (e.g., "cuda", "cpu", "mps").
</ResponseField>

<ResponseField name="devices[].vram_total" type="integer">
  Total VRAM in bytes (for GPUs).
</ResponseField>

<ResponseField name="devices[].vram_free" type="integer">
  Free VRAM in bytes (for GPUs).
</ResponseField>

<ResponseField name="dev_mode" type="boolean" required>
  Whether ComfyUI is running in development mode.
</ResponseField>

<ResponseField name="extensions" type="string[]" required>
  Array of installed ComfyUI extensions/custom nodes.
</ResponseField>

## Example Response

```json theme={null}
{
  "system": {
    "os": "posix",
    "ram_free": 239499096064,
    "ram_total": 253344550912,
    "comfyui_version": "0.3.77",
    "python_version": "3.12.12 (main, Oct 15 2025, 09:20:08) [GCC]"
  },
  "devices": [
    {
      "name": "cuda:0 NVIDIA H100 80GB HBM3 : cudaMallocAsync",
      "type": "cuda",
      "vram_total": 84942848000,
      "vram_free": 84316848128
    }
  ],
  "dev_mode": false,
  "extensions": [
    "/extensions/core/groupNodeManage.js",
    "/extensions/core/groupNode.js",
    "/extensions/ComfyUI-Manager/comfyui-manager.js",
    "/extensions/rgthree-comfy/rgthree.js"
  ]
}
```

## Error Responses

<ResponseField name="401" type="error">
  Unauthorized - invalid or missing authentication token.
</ResponseField>

<ResponseField name="403" type="error">
  Forbidden - your account tier does not have access to managed runners. Upgrade to Pro or Plus tier.
</ResponseField>

<ResponseField name="404" type="error">
  Not Found - managed runner with the specified ID does not exist or is not available to your tier.
</ResponseField>

<ResponseField name="500" type="error">
  Internal Server Error - unable to retrieve stats from the managed runner.

  This is rare with managed runners due to high availability. Contact support if this persists.
</ResponseField>

## Notes

* Managed runners typically have high-end GPUs (A100, H100, RTX 4090)
* VRAM and RAM values are in bytes (divide by 1,073,741,824 for GB)
* Stats are fetched in real-time and reflect current resource usage
* Use this to verify runner capacity before scheduling complex workflows
* Response time is typically faster than user-owned runners due to optimized infrastructure