---
title: "List Users"
method: GET
path: "/api/auth/user"
tags: ["Auth API"]
---

# List Users

`GET /api/auth/user`

## Request

- The document declares no server URL.
- Auth: none declared

List all users with optional filtering.

Args:
    start_index: Pagination start (1-based, default: 1)
    count: Results per page (default: 100, max: 1000)
    id_prefix: Filter users whose ID starts with this prefix
    roles: List of role names. Returns users who have ANY of these roles.
           Use multiple query params: ?roles=admin&roles=user

Returns:
    UserListResponse with paginated user list

## Query parameters

- `start_index` integer
- `count` integer
- `id_prefix` string, nullable
- `roles` string[], nullable

## Response `200`

Successful Response

- UserListResponse: Response for listing users.
  - `total_results` integer, required
  - `start_index` integer, required
  - `items_per_page` integer, required
  - `users` User[], required
    - `id` string, required
    - `created_at` string, date-time, nullable
    - `created_by` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-03** `b9d312a13f5d`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-04-08** `a8157dc3279d`: 2 breaking, 4 info
  - response property `users/items/created_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `users/items/created_by` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - `query` request parameter `id_prefix` list-of-types was widened by adding types `null`
  - `query` request parameter `roles` list-of-types was widened by adding types `null`
  - …2 more
- **2026-02-27** `3b4b243276b5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/auth/user/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/revisions/845585a71dbb?raw)