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

# List plots for a project

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

List all plots 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 plots are sorted in their index order. The HTTP response header `X-Total-Count` contains the total number of plots.

## Path parameters

- `project` string, required

## Query parameters

- `direction` 'asc' | 'desc'
- `page` integer, nullable
- `per_page` integer, nullable
- `sort` union
  - 'index' — Sort by plot index.
  - 'title' — Sort by plot title.
- `search` string
- `title` string

## Response `200`

successful operation

- JsonPlot[]
  - `benchmarks` BenchmarkUuid[], required
  - `branches` BranchUuid[], required
  - `created` string, date-time, required
  - `lower_boundary` boolean, required
  - `lower_value` boolean, required
  - `measures` MeasureUuid[], required
  - `modified` string, date-time, required
  - `project` string, uuid, required
  - `testbeds` TestbedUuid[], required
  - `title` string
  - `upper_boundary` boolean, required
  - `upper_value` boolean, required
  - `uuid` string, uuid, required
  - `window` integer, required
  - `x_axis` 'date_time' | 'version', required
  - `y_axis` union, required
    - 'auto' — Automatically adapt the y-axis scale to the data spread.
    - 'linear' — A linear y-axis scale that shows true magnitudes.
    - 'log' — A logarithmic y-axis scale.

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