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

# List Users

`GET /api/admin/users`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/admin/users`
- Auth: HTTP bearer

List users with search and filtering.

## Query parameters

- `search` string, nullable
- `filter` string, nullable
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- UserListResponse: Paginated user list.
  - `users` UserSummary[], required
    - `id` string, uuid, required
    - `email` string, required
    - `plan` string, required
    - `studio_plan` string, nullable
    - `studio_billing_period` string, nullable
    - `studio_subscription_status` string, nullable
    - `agent_count` integer
    - `credit_balance` integer
    - `credit_subscription` integer
    - `credit_bonus` integer
    - `team_credit_balance` integer, nullable
    - `team_credit_subscription` integer, nullable
    - `team_credit_bonus` integer, nullable
    - `is_whitelisted` boolean, required
    - `whitelist_expires_at` string, date-time, nullable
    - `created_at` string, date-time, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)