GET /admin/points/transactions

Admin operation. Paginated query of all users' points transaction records under the tenant, filterable by type and user, sorted by creation time in descending order.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
page	query	integer	No	1			Page number
page_size	query	integer	No	20			Page size
type	query	string	No			enum: `earn`, `spend`, `expire`, `freeze`, `unfreeze`, `refund`, `adjust`	Transaction type
user_id	query	string	No				User ID filter

Responses

Status	Description	Schema
200	Paginated list of transaction records	dto.PointTransactionListResponse
400	Bad request	gitee_com_linmes_authms_base_dto.SimpleResponse
401	Unauthorized	gitee_com_linmes_authms_base_dto.SimpleResponse
403	Forbidden	gitee_com_linmes_authms_base_dto.SimpleResponse
500	Internal server error	gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.PointTransactionListResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
items	array of See dto.PointTransactionResponse	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)

dto.PointTransactionResponse

Field	Type	Required	Example	Constraints	Description
account_id	string	No	01ARZ3NDEKTSV4RRFFQ69G5FAV
amount	integer	No	100
balance_after	integer	No	1500
balance_before	integer	No	1400
created_at	string	No	2026-04-15T10:30:00Z
description	string	No	Daily check-in reward
expires_at	string	No	2027-01-15T10:30:00Z
id	string	No	01ARZ3NDEKTSV4RRFFQ69G5FAV
idempotency_key	string	No	ik_abc123
reason	string	No	Check-in reward
related_id	string	No	01ARZ3NDEKTSV4RRFFQ69G5FAV
source	string	No	daily_checkin
status	string	No	completed
type	string	No	earn
updated_at	string	No	2026-04-15T10:30:00Z
user_id	string	No	usr_example_001

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