GET /points/{user_id}/transactions
Paginated query of a user's points transaction history, filterable by type, sorted by creation time in descending order.
Points Service `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
|---|
user_id |
path |
string |
Yes |
|
|
|
User ID |
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 |
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 |
|
|
|
Autional API Wiki