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

# List Managed Runners

> Retrieve a paginated list of available managed runners

## Overview

Retrieve all managed runners available to your account. Managed runners are ComfyUI instances hosted and maintained by ComfyControl.

<Info>
  Access to managed runners requires a **Pro** or **Plus** tier subscription. Free tier users will receive a 403 Forbidden error.
</Info>

## Query Parameters

<ParamField query="page" type="integer">
  Page number to retrieve (default: 1, minimum: 1).
</ParamField>

<ParamField query="per_page" type="integer">
  Number of runners per page (default: 10, minimum: 1, maximum: 100).
</ParamField>

## Response

<ResponseField name="runners" type="array" required>
  Array of managed runner objects.
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total number of managed runners available to your tier across all pages.
</ResponseField>

### Managed Runner Object

<ResponseField name="runners[].id" type="string" required>
  Unique identifier (UUID) for the managed runner.
</ResponseField>

<ResponseField name="runners[].name" type="string" required>
  The runner's name.
</ResponseField>

<ResponseField name="runners[].runner_type" type="string" required>
  Type of managed runner. Values: `plus`, `pro`
</ResponseField>

<ResponseField name="runners[].status" type="string" required>
  Current status of the runner. Values: `active`, `disabled`
</ResponseField>

<ResponseField name="runners[].tags" type="string[]" required>
  Array of tags associated with the runner for workflow matching.
</ResponseField>

<ResponseField name="runners[].created_at" type="string" required>
  ISO 8601 timestamp when the runner was created.
</ResponseField>

<ResponseField name="runners[].updated_at" type="string" required>
  ISO 8601 timestamp when the runner was last updated.
</ResponseField>

## Example Response

```json theme={null}
{
  "runners": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Managed Pro Runner 1",
      "runner_type": "pro",
      "status": "active",
      "tags": ["managed", "gpu-a100", "high-performance"],
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Managed Plus Runner 1",
      "runner_type": "plus",
      "status": "active",
      "tags": ["managed", "gpu-rtx4090", "standard"],
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 2
}
```

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

## Notes

* Only active managed runners are returned in the list
* Managed runners are maintained by ComfyControl with high availability
* Runner type corresponds to your subscription tier (Pro or Plus)
* Results are ordered by creation date (newest first)
* The `total` field indicates the total count of available managed runners for your tier