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

# Get Users

`GET /api/admin/users`

Get all users with filtering and sorting.

## Query parameters

- `search` string, nullable
- `tier` string, nullable
- `plan` string, nullable
- `has_enterprise_key` boolean, nullable
- `balance_min` number, nullable
- `balance_max` number, nullable
- `date_from` string, nullable
- `date_to` string, nullable
- `page` integer
- `limit` integer
- `sort_by` 'created_at' | 'full_name' | 'company_name' | 'last_login' | 'last_request_at' | 'total_used_money' | 'total_uploaded_money' | 'lifetime_charges' | 'current_remaining_credits' | 'total_api_calls' | 'tier' | 'plan' | 'prepaid_added' | 'prepaid_balance' | 'prepaid_spent' | 'postpaid_paid' | 'postpaid_unpaid' | 'postpaid_current_month' | 'postpaid_total' | 'total_requests' | 'total_tokens'
- `sort_order` 'asc' | 'desc'
- `skip_emails` boolean
- `segment` string, nullable

## Response `200`

Successful Response

- UserListResponse
  - `success` boolean
  - `users` UserBasic[]
    - `user_id` string, required
    - `email` string, nullable
    - `full_name` string, nullable
    - `company_name` string, nullable
    - `country` string, nullable
    - `role` 'user' | 'admin' | 'support'
    - `tier` 'tier1' | 'tier2' | 'tier3' | 'tier4' | 'tier5'
    - `account_type` 'user' | 'enterprise' — Account type: determines billing mode and allowed API key scopes. - USER: Prepaid wallet billing, can create user-scope keys - ENTERPRISE: Postpaid invoice billing, can create enterprise-scope keys
    - `prepaid_added` number
    - `prepaid_balance` number
    - `prepaid_spent` number
    - `postpaid_paid` number
    - `postpaid_unpaid` number
    - `postpaid_current_month` number
    - `total_requests` integer
    - `total_tokens` integer
    - `requests_rejected_30d` integer
    - `created_at` string, nullable
    - `last_login` string, nullable
    - `last_request_at` string, nullable
  - `total` integer
  - `page` integer
  - `limit` integer
  - `tier_distribution` object
  - `admin_count` integer

## Other responses

- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/compresr/apis/compresr-platform-api.md) · [All operations](https://skmtc.net/compresr/apis/compresr-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/compresr/compresr-platform-api/revisions/93ee959dfa51/schema)