GET /points/{user_id}/expiring

Query the details of points that will expire within the next N days in the user's account, including source, amount, expiration date, and remaining days for each entry.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
user_id	path	string	Yes				User ID
days	query	integer	No	30			Query days range

Responses

Status	Description	Schema
200	Expiring points details	dto.ExpiringPointDetailResponse
400	Bad request	gitee_com_autional_base_dto.SimpleResponse
401	Unauthorized	gitee_com_autional_base_dto.SimpleResponse
404	User not found	gitee_com_autional_base_dto.SimpleResponse
500	Internal server error	gitee_com_autional_base_dto.SimpleResponse

Referenced Schemas

dto.ExpiringPointDetailResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.ExpiringPointsResponse	No
message	string	No
timestamp	string	No

dto.ExpiringPointResponse

Field	Type	Required	Example	Constraints	Description
amount	integer	No	500
days_left	integer	No	7
expires_at	string	No	2026-06-15T00:00:00Z
source	string	No	signup_bonus
transaction_id	string	No	01ARZ3NDEKTSV4RRFFQ69G5FAV

dto.ExpiringPointsResponse

Field	Type	Required	Example	Constraints	Description
days_threshold	integer	No	30
expiring_points	array of See dto.ExpiringPointResponse	No
total_expiring	integer	No	1500
user_id	string	No	usr_example_001

gitee_com_autional_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No