List Company Wallets API

Overview

Allows Super Admins to list all corporate company wallets with search, pagination, and active status filters.

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

Request Query Parameters

Parameter	Type	Required	Description
search	String	No	Search query by company name or legal name
page	Number	No	Page number (Default: 1)
limit	Number	No	Items per page (Default: 10, Max: 100)
activeOnly	Boolean	No	Filter active wallets only

Request Example

GET /api/wallet/list?search=Abbott&page=1&limit=10

Response Example (200 OK)

{
  "success": true,
  "data": {
    "wallets": [
      {
        "id": "wlt_11223344",
        "companyId": "c478a846-993d-4c8d-bf8d-d77cb3370e01",
        "balance": 500000.00,
        "active": true,
        "company": {
          "id": "c478a846-993d-4c8d-bf8d-d77cb3370e01",
          "name": "Abbott Healthcare"
        }
      }
    ],
    "pagination": {
      "totalCount": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Company wallets fetched successfully"
}