---
title: "Admin List Balances"
method: GET
path: "/api/v1/admin/billing/users"
tags: ["Billing"]
---

# Admin List Balances

`GET /api/v1/admin/billing/users`

## Request

- Base URL: `https://api.clipmaster.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clipmaster.app/api/v1/admin/billing/users`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List all users with their token balances (admin-only).

## Query parameters

- `skip` integer
- `limit` integer
- `sort_by` string: Sort by: balance, total_spent, created_at

## Response `200`

Successful Response

- AdminUserBalanceListResponse
  - `data` AdminUserBalanceResponse[], required
    - `user_id` integer, required
    - `email` string, required
    - `full_name` string, nullable
    - `balance` integer, required
    - `reserved` integer, required
    - `available` integer, required
    - `total_purchased` integer, required
    - `total_spent` integer, required
    - `created_at` string, date-time, nullable
  - `total` integer, required
  - `skip` integer, required
  - `limit` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent.md) · [All operations](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/revisions/c9b8333cd22b?raw)