GET /admin/users
List users under a tenant, filterable by status and keyword search
Account Management `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|
status |
query |
string |
No |
|
|
|
User status |
search |
query |
string |
No |
|
|
|
Search keyword |
page |
query |
integer |
No |
1 |
|
|
Page number |
limit |
query |
integer |
No |
20 |
|
|
Items per page |
Referenced Schemas
dto.AuthUserResponse
Authenticated user info
| Field | Type | Required | Example | Constraints | Description |
|---|
age_group |
string |
No |
|
|
Age group |
birth_date |
string |
No |
|
|
Date of birth (RFC3339) |
created_at |
string |
No |
2026-01-01T00:00:00Z |
|
Created at |
email |
string |
No |
john@example.com |
|
Email |
email_verified_at |
string |
No |
2026-01-10T08:00:00Z |
|
Email verified at |
id |
string |
No |
usr_abc123 |
|
User ID |
is_minor |
boolean |
No |
|
|
Is minor |
last_login_at |
string |
No |
2026-04-14T10:30:00Z |
|
Last login |
last_login_ip |
string |
No |
192.168.1.1 |
|
Last login IP |
locked_until |
string |
No |
2026-04-15T12:00:00Z |
|
Lockout end |
login_fail_count |
integer |
No |
0 |
|
Failure count |
metadata |
object |
No |
|
|
Extended metadata |
mfa_enabled |
boolean |
No |
False |
|
MFA enabled |
mfa_type |
string |
No |
totp |
|
MFA type |
must_change_password |
boolean |
No |
False |
|
Force password change |
password_changed_at |
string |
No |
|
|
Password last changed at |
pending_parental_consent |
boolean |
No |
|
|
Awaiting parental consent |
phone |
string |
No |
13800138000 |
|
Phone number |
phone_verified_at |
string |
No |
2026-01-10T08:00:00Z |
|
Phone verified at |
status |
string |
No |
active |
|
Status |
tenant_id |
string |
No |
tnt_xyz789 |
|
Tenant ID |
updated_at |
string |
No |
2026-04-10T14:20:00Z |
|
Updated at |
username |
string |
No |
john_doe |
|
Username |
dto.UserListResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
items |
array of
See dto.AuthUserResponse |
No |
|
|
Use items uniformly |
message |
string |
No |
|
|
|
pagination |
object |
No |
|
|
Pagination information (nested object) |
timestamp |
string |
No |
|
|
|
total |
integer |
No |
|
|
Total count (flattened for direct reading) |
gitee_com_linmes_authms_base_dto.PageInfo
| Field | Type | Required | Example | Constraints | Description |
|---|
has_next |
boolean |
No |
|
|
HasNext indicates whether there is a next page |
has_prev |
boolean |
No |
|
|
HasPrev indicates whether there is a previous page |
page |
integer |
No |
|
|
Page is the current page number (1-based) |
page_size |
integer |
No |
|
|
PageSize is the number of items per page |
total |
integer |
No |
|
|
Total is the total number of items across all pages |
total_pages |
integer |
No |
|
|
TotalPages is the total number of pages |
Autional API Wiki