Get Wallet Flows

GET/web/v1/wallets/{walletBizId}/flows JWT

Retrieves a paginated list of transaction flows (ledger entries) for a specific wallet.

Authentication

Requires a valid JWT token and Turnstile verification.

Request Parameters

Name	Type	Required	In	Description
walletBizId	string	Required	path	Wallet business ID (path parameter)
page	integer	Optional	query	Page number (0-based). Default: 0
size	integer	Optional	query	Page size. Default: 20
sort	string	Optional	query	Sort field and direction (e.g. "createdAt,desc")

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "content": [
      {
        "flowId": "FLW20260321000001",
        "flowType": "DEBIT",
        "bizType": "TRANSFER",
        "amount": 100.5,
        "balanceAfter": 1399.5,
        "remark": "Transfer to WLT-002",
        "createdAt": "2026-03-21T10:00:00Z"
      },
      {
        "flowId": "FLW20260321000002",
        "flowType": "CREDIT",
        "bizType": "TRANSFER",
        "amount": 200,
        "balanceAfter": 1500,
        "remark": "Transfer from WLT-003",
        "createdAt": "2026-03-21T09:00:00Z"
      }
    ],
    "totalElements": 2,
    "totalPages": 1,
    "size": 20,
    "number": 0
  }
}

Error Responses

HTTP Status	Code	Description
401	4010	Unauthorized
404	4040	Wallet not found

Notes

• flowType indicates the direction: DEBIT (money out) or CREDIT (money in).
• bizType indicates the business context (e.g. TRANSFER, PAYMENT).
• balanceAfter shows the wallet balance after this transaction was applied.