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

# List all users

`GET /v1/users`

Retrieve a paginated list of all users in the system.

## Query parameters

- `cursor` string — Cursor for pagination (base64-encoded user ID)
- `limit` integer — The max number of users to return at a time.

## Response `200`

A list of users.

- GetUsersResponseBody
  - `data` union[], required
    - union
      - LocalUser
        - `id` string, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `email` string, required
        - `username` string, required
        - `role` 'SYSTEM' | 'ADMIN' | 'MEMBER' | 'VIEWER', required
        - `auth_method` 'LOCAL', required
        - `password` string
        - `password_needs_reset` boolean, required
      - OAuth2User
        - `id` string, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `email` string, required
        - `username` string, required
        - `role` 'SYSTEM' | 'ADMIN' | 'MEMBER' | 'VIEWER', required
        - `auth_method` 'OAUTH2', required
        - `oauth2_client_id` string
        - `oauth2_user_id` string
        - `profile_picture_url` string
      - LDAPUser
        - `id` string, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `email` string, required
        - `username` string, required
        - `role` 'SYSTEM' | 'ADMIN' | 'MEMBER' | 'VIEWER', required
        - `auth_method` 'LDAP', required
  - `next_cursor` string, nullable, required

## Other responses

- `403` — Forbidden
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-phoenix-rest-api/versions/a14d8ad6f708/schema)