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

# List USD virtual accounts

> List all USD virtual accounts

## Overview

Lists all USD virtual accounts for the authenticated merchant with optional filtering by customer and status. Each virtual account includes `developer_fee.percentage`.

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your merchant API key
</ParamField>

## Query Parameters

<ParamField query="limit" type="integer">
  Number of results per page (default: 50, max: 200)
</ParamField>

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

<ParamField query="customer_id" type="string">
  Filter by customer ID (UUID)
</ParamField>

<ParamField query="status" type="string">
  Filter by status

  **Allowed values:** `active` | `inactive`
</ParamField>

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.daya.co/v1/virtual-accounts?limit=50&page=1' \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```
</CodeGroup>

## Response

<ResponseField name="data" type="array" required>
  Array of virtual account objects
</ResponseField>

<ResponseField name="page" type="integer" required>
  Current page number
</ResponseField>

<ResponseField name="limit" type="integer" required>
  Results per page
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total number of virtual accounts
</ResponseField>

<ResponseField name="total_pages" type="integer" required>
  Total number of pages
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "650e8400-e29b-41d4-a716-446655440000",
        "customer_id": "650e8400-e29b-41d4-a716-446655440002",
        "merchant_id": "650e8400-e29b-41d4-a716-446655440001",
        "currency": "usd",
        "status": "active",
        "provider": "bridge",
        "developer_fee": {
          "percentage": "1.5"
        },
        "deposit_instructions": {
          "bank_beneficiary_name": "Bridge Trust",
          "bank_beneficiary_address": "123 Finance St, New York, NY",
          "bank_name": "Lead Bank",
          "bank_address": "1801 Main St, Kansas City, MO",
          "bank_routing_number": "101019644",
          "bank_account_number": "1234567890",
          "payment_rails": ["ach", "wire"]
        },
        "destination": {
          "payment_rail": "base",
          "currency": "usdc",
          "address": "0x1234567890abcdef1234567890abcdef12345678"
        },
        "created_at": "2026-01-05T15:04:05Z",
        "updated_at": "2026-01-05T15:04:05Z"
      }
    ],
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1
  }
  ```
</ResponseExample>