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

# List projects

`GET /v0/projects`

List all projects. If the user is not authenticated, then only public projects are returned. If the user is authenticated, then all public projects and any private project where the user has `view` permissions are returned. If a project key is provided, then only the key's project is returned. By default, the projects are sorted in alphabetical order by name. The HTTP response header `X-Total-Count` contains the total number of projects.

## Query parameters

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

## Response `200`

successful operation

- JsonProject[]
  - `claimed` string, date-time
  - `created` string, date-time, required
  - `modified` string, date-time, required
  - `name` string, required
  - `organization` string, uuid, required
  - `slug` string, required
  - `url` string
  - `uuid` string, uuid, required
  - `visibility` 'public' | 'private', 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)