List Top-Up Requests API

Overview

Allows Super Admins or Corporate Admins to query top-up request history filtered by company or status (REQUESTED, APPROVED, REJECTED, CANCELLED).

• Endpoint: /api/wallet/requests/list
• Method: POST
• Auth Required: Yes (Bearer <token>)

Request Body Schema

Field	Type	Required	Description
companyId	String (UUID)	No	Optional company ID filter
status	Enum	No	Filter by request status: REQUESTED, APPROVED, REJECTED, CANCELLED
page	Number	No	Page number (Default: 1)
limit	Number	No	Items per page (Default: 10, Max: 100)

Request Body Example

{
  "companyId": "c478a846-993d-4c8d-bf8d-d77cb3370e01",
  "status": "REQUESTED",
  "page": 1,
  "limit": 10
}

Response Example (200 OK)

{
  "success": true,
  "data": {
    "requests": [
      {
        "id": "req_11223344",
        "companyId": "c478a846-993d-4c8d-bf8d-d77cb3370e01",
        "amount": 250000.00,
        "reason": "Quarterly travel surge",
        "status": "REQUESTED",
        "rejectionReason": null,
        "referenceNo": null,
        "createdAt": "2026-09-04T10:00:00.000Z",
        "updatedAt": "2026-09-04T10:00:00.000Z"
      }
    ],
    "pagination": {
      "totalCount": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Top-up requests fetched successfully"
}