---
title: "List runner pools"
method: GET
path: "/runners/runner-pools"
tags: ["Self-Hosted Runners"]
---

# List runner pools

`GET /runners/runner-pools`

Retrieves all runner pools for the account

## Query parameters

- `searchQuery` string — Search query
- `pageSize` integer
- `offset` integer
- `status` PoolHealthStatus[]
- `labels` string[]
- `sort` object
  - `field` 'name' | 'createdAt' | 'updatedAt' | 'runnersCount' | 'assignedProjectsCount' | 'assignedWorkspaceCount' | 'poolStatus'
  - `direction` 'asc' | 'desc'

## Response `200`

Runner pools retrieved successfully

- RunnerPool[]
  - `id` string — Unique identifier for the runner pool
  - `name` string — Name of the runner pool
  - `accountId` string — ID of the account the pool belongs to
  - `labels` string[] — Labels assigned to the runner pool
  - `description` string — Description of the runner pool
  - `runnersCount` integer — Number of runners in the pool
  - `assignedProjectsCount` integer — Number of projects assigned to this pool
  - `assignedWorkspaceCount` integer — Number of workspaces assigned to this pool
  - `assignedProjects` object[] — List of projects assigned to this pool
    - `id` string
    - `name` string
  - `assignedWorkspaces` object[] — List of workspaces assigned to this pool
    - `id` string
    - `name` string
  - `health` PoolHealth
    - `poolStatus` 'healthy' | 'partial' | 'inactive' — Overall health status of the pool
    - `statusByRunner` object — Map of runner ID to runner health status
  - `createdAt` string, date-time — Timestamp when the pool was created
  - `updatedAt` string, date-time — Timestamp when the pool was last updated

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Insufficient permissions
- `500` — Internal Server Error

---

[API](https://skmtc.net/firefly/apis/api-gateway.md) · [All operations](https://skmtc.net/firefly/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/api-gateway/revisions/eea119b4113f/schema)