---
title: "List testbeds for a project"
method: GET
path: "/v0/projects/{project}/testbeds"
tags: ["projects", "testbeds"]
---

# List testbeds for a project

`GET /v0/projects/{project}/testbeds`

List all testbeds for a project. If the project is public, then the user does not need to be authenticated. If the project is private, then the user must be authenticated and have `view` permissions for the project, or provide a valid project key for the project. By default, the testbeds are sorted in alphabetical order by name. The HTTP response header `X-Total-Count` contains the total number of testbeds.

## Path parameters

- `project` string, required

## Query parameters

- `direction` 'asc' | 'desc'
- `page` integer, nullable
- `per_page` integer, nullable
- `sort` 'name' — Sort by testbed name.
- `archived` boolean, nullable
- `name` string
- `search` string

## Response `200`

successful operation

- JsonTestbed[]
  - `archived` string, date-time
  - `created` string, date-time, required
  - `modified` string, date-time, required
  - `name` string, required
  - `project` string, uuid, required
  - `slug` string, required
  - `spec` JsonSpec — A hardware spec
    - `architecture` 'x86_64' | 'aarch64', required
    - `archived` string, date-time
    - `cpu` integer, required
    - `created` string, date-time, required
    - `disk` integer, required
    - `fallback` string, date-time
    - `memory` integer, required
    - `modified` string, date-time, required
    - `name` string, required
    - `network` boolean, required
    - `os` 'linux' | 'macos' | 'windows', required
    - `sandbox` 'firecracker'
    - `slug` string, required
    - `uuid` string, uuid, 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/versions/84086e99e6cd/schema)