List Virtual Accounts

This retrieves and lists all the active virtual accounts you created.

GET https://api.spotflow.co/api/v1/virtual-accounts

Headers

authorization String	Bearer SECRET_KEY Include your secret key in the request header as a Bearer token for authorization. Unauthorized requests will result in a 401 HTTP status code.

Query Parameters

accountNumber String	This filters by the account number created for the sub accounts.

Sample Response:

200 OK

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "accountNumber": "1234567890",
    "accountName": "John Doe",
    "bankName": "Access Bank",
    "type": "INDIVIDUAL",
    "mode": "live",
    "createdAt": "2025-05-19T10:15:30Z",
    "updatedAt": "2025-05-19T10:15:30Z",
    "lifecycle": "temporary",
    "amount": 900,
    "reference": "001",
    "expiresAt": "2025-05-19T10:45:30Z"
  }
]