---
title: "List runners"
method: GET
path: "/v0/runners"
tags: ["runners"]
---

# List runners

`GET /v0/runners`

➕ Bencher Plus: List all runners on the server. The user must be an admin to use this endpoint.

## Query parameters

- `direction` 'asc' | 'desc'
- `page` integer, nullable
- `per_page` integer, nullable
- `sort` union
  - 'name' — Sort by runner name.
  - 'created' — Sort by creation date.
- `archived` boolean
- `name` string
- `search` string

## Response `200`

successful operation

- JsonRunner[] — List of runners
  - `archived` string, date-time
  - `created` string, date-time, required
  - `last_heartbeat` string, date-time
  - `modified` string, date-time, required
  - `name` string, required
  - `slug` string, required
  - `specs` SpecUuid[], required
  - `uuid` string, uuid, required

## Other responses

- `4XX` — Error
- `5XX` — Error

---

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