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.

Points Service `bearerAuth` application/json

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_linmes_authms_base_dto.SimpleResponse`
401	Unauthorized	`gitee_com_linmes_authms_base_dto.SimpleResponse`
404	User not found	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.ExpiringPointDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.ExpiringPointsResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.ExpiringPointResponse

Field	Type	Required	Example
`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
`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_linmes_authms_base_dto.SimpleResponse

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

GET /points/{user_id}/expiring