List virtual accounts for your business.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/wallets

Query Parameters

Field	Data Type	Required	Description
page	integer	No	Page to retrieve. Defaults to `1`.
limit	integer	No	Records per page. Maximum is `100`.
order	string	No	`ASC` or `DESC`. Defaults to `DESC`.
sort	string	No	Field to sort by. Defaults to `createdAt`.
query	string	No	Search by account number.
startDate	string	No	ISO date/time start filter.
endDate	string	No	ISO date/time end filter.
integrationId	string	No	Filter by integration ID.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "pageCount": 1,
    "hasPreviousPage": false,
    "hasNextPage": false,
    "data": [
      {
        "id": "89d8f903-96f6-48df-af97-1f2b3bb64260",
        "accountNumber": "1234567890",
        "accountName": "KYSHI / ADA OKAFOR",
        "bankCode": "999999",
        "bankName": "Provider Bank",
        "balance": 5000,
        "active": true,
        "mode": "live",
        "accountCategory": "VIRTUAL_ACCOUNT",
        "accountType": "INDIVIDUAL",
        "reference": "VA_123456789",
        "provider": "VFD",
        "createdAt": "2026-05-20T10:15:00.000Z"
      }
    ]
  }
}