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

# List Virtual Accounts

> Retrieve all virtual accounts for the smart account with optional currency filters

Retrieve all virtual accounts associated with your smart account. Use optional filters to narrow results by currency or payment rail.

## Filtering Options

You can filter virtual accounts by:

* **Source Currency**: USD, EUR, GBP
* **Destination Currency**: USDC, USDT, PYUSD, EURC
* **Status**: activated, deactivated

## Account Information

Each virtual account includes:

* Bank deposit instructions (routing number, account number)
* Supported payment rails (ACH, SEPA, Wire)
* Destination currency configuration
* Current activation status
* Developer fee percentage (if applicable)

## Important Notes

* Only activated virtual accounts can receive deposits
* Each currency combination requires a separate virtual account
* Virtual account details should be shared securely with depositors
* Monitor account status regularly for compliance updates


## OpenAPI

````yaml GET /api/grid/v1/accounts/{address}/virtual-accounts
openapi: 3.1.0
info:
  title: Grid v1 API
  description: Grid v1 REST API for Solana-based smart account system
  contact:
    name: Grid API Support
    url: https://squads.so
    email: support@squads.so
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://grid.squads.xyz
    description: Production server
security:
  - bearer_auth: []
tags:
  - name: accounts
    description: Smart account management operations
  - name: spending-limits
    description: Spending limit management
  - name: standing-orders
    description: Standing order operations
  - name: transactions
    description: Transaction management
  - name: trade
    description: Trade operations and management
  - name: payments
    description: Payment intent operations
  - name: passkeys
    description: Passkey management
  - name: kyc
    description: Know Your Customer operations
  - name: external-accounts
    description: External bank account management
  - name: virtual-accounts
    description: Virtual account management
  - name: auth
    description: Authentication operations
  - name: proposals
    description: Proposal management for multi-sig operations
  - name: compliance
    description: Compliance entity management and KYB/KYC operations
paths:
  /api/grid/v1/accounts/{address}/virtual-accounts:
    get:
      tags:
        - virtual-accounts
      summary: Get all virtual accounts for a smart account
      description: >-
        Retrieve all virtual accounts associated with a smart account with
        optional currency filtering
      operationId: handler
      parameters:
        - name: address
          in: path
          description: Smart account address
          required: true
          schema:
            type: string
        - name: source_currency
          in: query
          description: Filter by source currency
          required: false
          schema:
            type: string
        - name: destination_currency
          in: query
          description: Filter by destination currency
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Virtual accounts retrieved successfully
        '400':
          description: Invalid query parameters
        '404':
          description: Smart account not found
        '500':
          description: Internal server error
      security:
        - bearer_auth: []
components:
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      description: Your Grid API key from the Grid Dashboard

````