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

# List users

`GET /v0/users`

List all users. The user must be an admin on the server to use this route. The HTTP response header `X-Total-Count` contains the total number of users.

## Query parameters

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

## Response `200`

successful operation

- JsonUser[]
  - `admin` boolean, required
  - `created` string, date-time
  - `email` string, required
  - `locked` boolean, required
  - `name` string, required
  - `slug` string, required
  - `uuid` string, uuid, required

## Other responses

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

## Changes

- **2026-06-14** `814ceb2390ab` — 1 info
  - added the optional property `items/created` to the response with the `200` status
- **2026-03-20** `36c8ad753527` — 1 warning
  - removed the optional property `items/created` from the response with the `200` status

[Change history](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/users/get.md)

---

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