> ## Documentation Index > Fetch the complete documentation index at: https://flutterwaveinc.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List all virtual accounts ## OpenAPI ````yaml Flutterwave_v4_Open_API.json get /virtual-accounts openapi: 3.1.0 info: version: '1.0' title: Flutterwave APIs description: APIs for Enterprise Customers contact: name: Flutterwave email: hi@flutterwavego.com servers: - url: https://developersandbox-api.flutterwave.com description: Dev server security: - bearerAuth: [] paths: /virtual-accounts: get: tags: - Virtual-Accounts summary: List all virtual accounts operationId: virtual_accounts_list parameters: - $ref: '#/components/parameters/trace_id' - $ref: '#/components/parameters/to_datetime' - $ref: '#/components/parameters/from_datetime' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/size' - $ref: '#/components/parameters/reference' responses: '200': description: OK content: application/json: schema: type: object additionalProperties: false properties: status: $ref: '#/components/schemas/status' message: type: string meta: $ref: '#/components/schemas/list_response_meta' data: type: array maxItems: 10 items: $ref: '#/components/schemas/virtual_account' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/400' '401': description: Unauthorised request content: application/json: schema: $ref: '#/components/schemas/401' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/403' components: parameters: trace_id: description: >- A unique identifier to track this operation. It must be between 12 and 255 characters in length. in: header name: X-Trace-Id schema: type: string minLength: 12 maxLength: 255 example: acb123e4-f567-4a8b-9c0d-1e2f3a4b5c6d to_datetime: in: query name: to schema: type: string format: date-time description: >- The end date and time for a period. This parameter is used in conjunction with the 'from' parameter to define a time range. The value should be in **ISO 8601 format**. example: '2025-05-21T10:48:18Z' from_datetime: in: query name: from schema: type: string format: date-time description: >- The start date and time for a period. This parameter is used in conjunction with the 'to' parameter to define a time range. The value should be in ISO 8601 format. example: '2025-04-21T10:55:16Z' page: in: query name: page description: >- The page of the data to retrieve. The most recent data entry is on page 1. schema: type: integer minimum: 1 default: 1 example: 1 size: in: query name: size description: Length of data returned. Defaults to 10. schema: type: integer minimum: 10 maximum: 50 default: 10 example: 10 reference: in: query name: reference schema: type: string description: >- A custom identifier to track the transaction, This must be unique across all your transactions. example: ashsfGHhdjsdXzGThakTTysDsw schemas: '400': description: Bad Request type: object properties: status: type: string nullable: false enum: - failed error: type: object properties: type: type: string example: REQUEST_NOT_VALID code: type: string example: '10400' message: type: string nullable: true example: Request is not valid validation_errors: type: array items: type: object properties: field_name: type: string example: amount message: type: string example: must not be null description: >- The request cannot be accepted and is malformed and/or missing required parameters. '401': description: Unauthorized type: object properties: status: type: string nullable: false enum: - failed message: type: string nullable: true description: Invalid API key provided example: UNAUTHORIZED error: type: object properties: type: type: string example: UNAUTHORIZED code: type: string example: '10401' message: type: string example: unauthorized '403': description: Forbidden type: object properties: status: type: string nullable: false enum: - failed message: type: string description: API key doesn't have permission to access this resource error: type: object properties: type: type: string example: FORBIDDEN code: type: string example: '10403' message: type: string example: Forbidden status: type: string nullable: false enum: - success - failed list_response_meta: type: object properties: page_info: $ref: '#/components/schemas/page_info' virtual_account: type: object properties: id: type: string description: The virtual account ID. example: '' amount: type: number description: The amount to be collected. Specify `0` for static accounts. example: 1000 format: decimal account_number: type: string description: The bank account number. example: '7824822527' reference: type: string description: >- A custom identifier to track the transaction, This must be unique across all your transactions. example: htuy68787hvhyff454 account_bank_name: type: string description: The name of the bank. example: WEMA BANK account_type: $ref: '#/components/schemas/pwbt_type' status: $ref: '#/components/schemas/virtual_account_status' account_expiration_datetime: type: string, format: date-time description: The expiry date and time of the virtual account. example: '2025-12-03T13:54:21.546559974Z' note: type: string description: >- A message providing instructions for the bank transfer, which includes the narration provided in the request. example: Please make a bank transfer to James Burgers customer_id: type: string description: The ID of the customer. example: cus_J0PvwvJB2n created_datetime: type: string format: date-time description: The date and time when the virtual account was created.. example: '2024-12-03T13:54:21.546559974Z' meta: $ref: '#/components/schemas/meta' customer_reference: type: string description: >- This is the reference the customer sends as narration when making the bank transfer example: AEGP2345 currency: type: string description: ISO 4217 currency code. example: NGN page_info: type: object properties: total: type: integer description: The total number of items available across all pages format: int64 current_page: type: integer description: The current page number being viewed format: int64 total_pages: type: integer description: The total number of pages required to display all items. format: int64 pwbt_type: type: string description: The type of virtual account. example: static enum: - static - dynamic virtual_account_status: type: string description: The status of the virtual account. enum: - active - inactive meta: type: object additionalProperties: type: string securitySchemes: bearerAuth: type: http scheme: bearer ````