Skip to main content
GET
/
v1
/
customers
/
{customer_id}
/
virtual-accounts
List customer virtual accounts
curl --request GET \
  --url https://api.daya.co/v1/customers/{customer_id}/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",
        "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 a specific customer under the authenticated merchant. The customer must have completed tier 2 verification to have virtual accounts.

​
Authentication

​
X-Api-Key
string
required
Your merchant API key

​
Path Parameters

​
customer_id
string
required
Customer ID (UUID format)Example: 650e8400-e29b-41d4-a716-446655440002

​
Query Parameters

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

​
Request Example

curl --request GET \
  --url 'https://api.daya.co/v1/customers/650e8400-e29b-41d4-a716-446655440002/virtual-accounts' \
  --header 'X-Api-Key: YOUR_API_KEY'

​
Response

​
data
array
required
Array of virtual account objects for the customer
​
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",
        "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
}