> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usepooler.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Virtual Accounts

> Retrieve a paginated list of all virtual accounts associated with your account.

Retrieve a paginated list of all virtual accounts associated with your account.

## Overview

This endpoint returns all virtual accounts you've created, allowing you to view their status, account numbers, and balances.

## Query Parameters

<ParamField query="page" type="integer">
  Page number for pagination (default: 1)
</ParamField>

<ParamField query="per_page" type="integer">
  Number of items per page (default: 10)
</ParamField>

## Response

<ResponseField name="data" type="object">
  Paginated response containing:

  * `total_pages`: Total number of pages
  * `current_page`: Current page number
  * `total_records`: Total number of virtual accounts
  * `next_page`: URL for next page
  * `previous_page`: URL for previous page
  * `items`: Array of virtual account objects
</ResponseField>

<ResponseField name="data.items[]" type="object">
  Each virtual account object includes:

  * `id`: Virtual account UUID
  * `account_no`: Account number
  * `account_name`: Account holder name
  * `bank_name`: Bank name
  * `currency_code`: Currency code
  * `active`: Whether account is active
  * `dob`: Date of birth of account holder if account is an individual account
  * `reference`: Account reference
  * `account_type`: Account type
  * `rc_number`: RC Number if account is a corporate/business account
  * `corporate_account_type`: Corporate account type if account is a corporate/business account
  * `status`: Status of account. Can be pending, active or failed
  * `metadata`: Additional metadata
  * `created_at`: Creation timestamp
</ResponseField>


## OpenAPI

````yaml GET /accounts/virtual-accounts
openapi: 3.0.0
info:
  title: Pooler Developer API
  description: >-
    Comprehensive API documentation for Pooler payment and financial services
    platform
  version: 1.0.0
servers:
  - url: https://api.usepooler.com
    description: Production server
  - url: https://sandbox.usepooler.com
    description: Sandbox server
security:
  - bearerAuth: []
paths:
  /accounts/virtual-accounts:
    get:
      tags:
        - Accounts
      summary: List Virtual Accounts
      description: >-
        Retrieve a paginated list of all virtual accounts associated with your
        account.
      operationId: listVirtualAccounts
      parameters:
        - name: page
          in: query
          description: Page number for pagination
          schema:
            type: integer
            default: 1
        - name: per_page
          in: query
          description: Number of items per page
          schema:
            type: integer
            default: 10
      responses:
        '200':
          description: Virtual accounts retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedVirtualAccountsResponse'
components:
  schemas:
    PaginatedVirtualAccountsResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        stan:
          type: string
          format: uuid
        data:
          $ref: '#/components/schemas/PaginatedVirtualAccounts'
    PaginatedVirtualAccounts:
      type: object
      properties:
        total_pages:
          type: integer
        current_page:
          type: integer
        total_records:
          type: integer
        next_page:
          type: string
        previous_page:
          type: string
        items:
          type: array
          items:
            $ref: '#/components/schemas/VirtualAccount'
    VirtualAccount:
      type: object
      properties:
        id:
          type: string
          format: uuid
        currency:
          type: string
        account_number:
          type: string
        account_name:
          type: string
        bank_name:
          type: string
        dob:
          type: string
        reference:
          type: string
        account_type:
          type: string
        active:
          type: boolean
        status:
          type: string
        rc_number:
          type: string
        corporate_account_type:
          type: string
        created_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer token authentication. Include your API key in the Authorization
        header as: Bearer {your_api_key}

````