GET /admin/tenants
Query the tenant list with pagination and filtering support.
Tenant Service `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|
status |
query |
string |
No |
|
|
|
Filter by status |
plan |
query |
string |
No |
|
|
|
Filter by plan |
search |
query |
string |
No |
|
|
|
Search by keyword |
page |
query |
integer |
No |
|
|
|
Page number |
page_size |
query |
integer |
No |
|
|
|
Items per page |
Referenced Schemas
dto.TenantListResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
items |
array of
See dto.TenantResponse |
No |
|
|
Use items consistently |
message |
string |
No |
|
|
|
pagination |
object |
No |
|
|
Pagination information (nested object) |
timestamp |
string |
No |
|
|
|
total |
integer |
No |
|
|
Total count (flat, for direct reading) |
dto.TenantResponse
Tenant details
| Field | Type | Required | Example | Constraints | Description |
|---|
brand_custom_css |
string |
No |
|
|
|
brand_favicon_url |
string |
No |
|
|
|
brand_logo_url |
string |
No |
|
|
|
brand_primary_color |
string |
No |
|
|
|
created_at |
string |
No |
2026-01-01T00:00:00Z |
|
Creation time |
display_name |
string |
No |
ACME Corporation |
|
Display name |
domain |
string |
No |
acme.example.com |
|
Domain |
id |
string |
No |
tnt_abc123 |
|
Tenant ID |
max_api_requests |
integer |
No |
10000 |
|
API request limit |
max_bandwidth |
integer |
No |
104857600 |
|
Bandwidth limit (bytes/month) |
max_storage |
integer |
No |
1073741824 |
|
Storage limit (bytes) |
max_users |
integer |
No |
100 |
|
User limit |
name |
string |
No |
acme-corp |
|
Tenant name |
owner_id |
string |
No |
usr_xyz789 |
|
Owner ID |
plan |
string |
No |
professional |
|
Subscription plan |
status |
string |
No |
active |
|
Status |
updated_at |
string |
No |
2026-04-10T14:20:00Z |
|
Update time |
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 |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
Autional API Wiki