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

# List Users

`GET /admin/users`

List users with pagination, filters, and sorting.

## Query parameters

- `page` integer
- `per_page` integer
- `search` string, nullable
- `role` string, nullable
- `is_active` boolean, nullable
- `sort_by` string, nullable
- `sort_order` string, nullable
- `date_from` string, date-time, nullable
- `date_to` string, date-time, nullable
- `credits_min` integer, nullable
- `credits_max` integer, nullable
- `balance_min` number, nullable
- `balance_max` number, nullable
- `tier` string, nullable

## Response `200`

Successful Response

- PaginatedResponse
  - `items` unknown[], required
    - unknown
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/meganova/apis/fastapi.md) · [All operations](https://skmtc.net/meganova/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meganova/fastapi/revisions/2b2bab8b9017/schema)