Skip to main content
GET
/
v1
/
virtual-accounts
List virtual accounts
curl --request GET \
  --url https://api.daya.co/v1/virtual-accounts \
  --header 'X-Api-Key: <x-api-key>'
{
  "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_percent": "0.5",
      "deposit_instructions": {
        "bank_beneficiary_name": "Bridge Trust",
        "bank_name": "Lead Bank",
        "bank_routing_number": "101019644",
        "bank_account_number": "1234567890",
        "deposit_message": "BRGXXXXXXXX",
        "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
}

Overview

Lists all USD virtual accounts for the authenticated merchant with optional filtering by customer and status.

Authentication

X-Api-Key
string
required
Your merchant API key

Query Parameters

limit
integer
Number of results per page (default: 50, max: 200)
page
integer
Page number (default: 1)
customer_id
string
Filter by customer ID (UUID)
status
string
Filter by statusAllowed values: active | inactive

Request Example

curl --request GET \
  --url 'https://api.daya.co/v1/virtual-accounts?limit=50&page=1' \
  --header 'X-Api-Key: YOUR_API_KEY'

Response

data
array
required
Array of virtual account objects
page
integer
required
Current page number
limit
integer
required
Results per page
total
integer
required
Total number of virtual accounts
total_pages
integer
required
Total number of pages
{
  "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_percent": "0.5",
      "deposit_instructions": {
        "bank_beneficiary_name": "Bridge Trust",
        "bank_name": "Lead Bank",
        "bank_routing_number": "101019644",
        "bank_account_number": "1234567890",
        "deposit_message": "BRGXXXXXXXX",
        "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
}