Get Wallet Transactions API

Overview

Retrieves transaction history ledger for a company wallet with pagination.

• Endpoint: /api/wallet/transactions
• Method: POST

Request Body Schema

Field	Type	Required	Description
companyId	String (UUID)	No	Target company ID filter
transactionType	Enum	No	Filter by type: CREDIT, DEBIT, REFUND, ADJUSTMENT, REWARD
startDate	String	No	ISO Date string filter start
endDate	String	No	ISO Date string filter end
search	String	No	Search query for description or reference number
page	Number	No	Page number (Default: 1)
limit	Number	No	Page limit (Default: 10)

Request Body Example

{
  "companyId": "c478a846-993d-4c8d-bf8d-d77cb3370e01",
  "transactionType": "DEBIT",
  "search": "Hotel",
  "page": 1,
  "limit": 10
}

Response Example (200 OK)

{
  "success": true,
  "data": {
    "transactions": [
      {
        "id": "txn_88990011",
        "type": "DEBIT",
        "amount": 20160.00,
        "balanceAfter": 579840.00,
        "description": "Hotel Booking Payment",
        "createdAt": "2026-09-01T14:30:00.000Z"
      }
    ],
    "pagination": { "totalCount": 1, "page": 1, "limit": 10, "totalPages": 1 }
  },
  "message": "Wallet transactions fetched successfully"
}