Skip to main content

List dynamic virtual accounts

GET/api/merchant/virtual-account/dynamic

List dynamic virtual accounts

Request

Parameters

NameLocationTypeRequired
statusquerystringNo
limitqueryintegerNo

Responses

200 Dynamic accounts

Example response

{
  "message": "dynamic accounts fetched",
  "response": [
    {
      "id": "66c9b4b736d142b900000001",
      "accountNumber": "0123456789",
      "accountName": "Order INV-1001",
      "bankName": "Aella Microfinance Bank",
      "currency": "NGN",
      "expectedAmount": 50000,
      "status": "active",
      "expiresAt": "2026-08-24T12:30:00.000Z",
      "providerBalance": 0,
      "onchainBalance": 0,
      "createdAt": "2026-08-24T12:00:00.000Z",
      "updatedAt": "2026-08-24T12:00:00.000Z"
    }
  ]
}