Virtual accounts

List accounts

Returns the virtual accounts connected to your business, newest first.

GET /v1/user_banks

Headers

Header	Value
Content-Type	`application/json`
api-key	Your business API key
secret-key	Your business secret key

Request body

Field	Type	Required	Notes
email	string	No	Narrows the list to the accounts issued to one customer.

Request

{
  "email": "customer@example.com"
}

Response

Field	Type	Notes
status	string	Outcome of the call.
message	string	Human readable result.
count	number	How many accounts came back.
data	array	The accounts.
data[].bank_name	string	Partner bank.
data[].account_name	string	Name on the account.
data[].account_number	string	Payable number.
data[].vol_reference	string	Volboo's identifier.
data[].client_reference	string	The `ref` you set at creation.
data[].created_at	string	When it was issued.

200 Success

{
  "status":  "success",
  "message": "Accounts retrieved",
  "count":   1,
  "data": [
    {
      "bank_name":        "9PSB",
      "account_name":     "AMANDA ELUMELU",
      "account_number":   "9060132960",
      "vol_reference":    "VOL-695E0C5DA6A9A",
      "client_reference": "order_10432",
      "created_at":       "2026-01-07T12:45:49+01:00"
    }
  ]
}

Errors

400 with Email parameter is required if the endpoint is called in a way that needs one. See Errors.