---
title: "List all virtual accounts"
method: GET
path: "/virtual-accounts"
tags: ["Virtual-Accounts"]
---

# List all virtual accounts

`GET /virtual-accounts`

## Query parameters

- `to` string, date-time
- `from` string, date-time
- `page` integer
- `size` integer
- `reference` string

## Headers

- `X-Trace-Id` string

## Response `200`

OK

- object
  - `status` 'success' | 'failed'
  - `message` string
  - `meta` ListResponseMeta
    - `page_info` PageInfo
      - `total` integer — The total number of items available across all pages
      - `current_page` integer — The current page number being viewed
      - `total_pages` integer — The total number of pages required to display all items.
  - `data` VirtualAccount[]
    - `id` string — The virtual account ID.
    - `amount` number — The amount to be collected. Specify `0` for static accounts.
    - `account_number` string — The bank account number.
    - `reference` string — A custom identifier to track the transaction, This must be unique across all your transactions.
    - `account_bank_name` string — The name of the bank.
    - `account_type` 'static' | 'dynamic' — The type of virtual account.
    - `status` 'active' | 'inactive' — The status of the virtual account.
    - `account_expiration_datetime` string, date-time — The expiry date and time of the virtual account.
    - `note` string — A message providing instructions for the bank transfer, which includes the narration provided in the request.
    - `customer_id` string — The ID of the customer.
    - `created_datetime` string, date-time — The date and time when the virtual account was created..
    - `meta` Meta
    - `customer_reference` string — This is the reference the customer sends as narration when making the bank transfer
    - `currency` string — ISO 4217 currency code.
    - `narration` string — This allows you specify the name shown when the account is resolved.

## Other responses

- `400` — Bad request
- `401` — Unauthorised request
- `403` — Forbidden

---

[API](https://skmtc.net/flutterwave/apis/flutterwave-apis.md) · [All operations](https://skmtc.net/flutterwave/apis/flutterwave-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flutterwave/flutterwave-apis/revisions/6014190df2e9/schema)