Skip to main content
GET
/
v1
/
virtual-accounts
/
{id}
Get virtual account
curl --request GET \
  --url https://api.daya.co/v1/virtual-accounts/{id} \
  --header 'X-Api-Key: <x-api-key>'
{
  "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_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",
    "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"
}

Overview

Retrieves a single USD virtual account by ID for the authenticated merchant. Response includes deposit instructions, destination, developer fee, status, and provider.

Authentication

X-Api-Key
string
required
Your merchant API key

Path Parameters

id
string
required
Virtual Account ID (UUID format)Example: 650e8400-e29b-41d4-a716-446655440000

Request Example

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

Response

Returns the full virtual account object including deposit instructions and destination details.
{
  "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_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",
    "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"
}