GET
/
virtual_accounts
/
history
Virtual Account Activity Across All Customers
curl --request GET \
  --url https://api.bridge.xyz/v0/virtual_accounts/history \
  --header 'Api-Key: <api-key>'
{
  "count": 2,
  "data": [
    {
      "value": {
        "id": "va_event_456",
        "customer_id": "cust_alice",
        "virtual_account_id": "va_123",
        "type": "payment_submitted",
        "amount": "120.0",
        "currency": "usd",
        "developer_fee_amount": "1.25",
        "exchange_fee_amount": "2.2",
        "subtotal_amount": "120.0",
        "gas_fee": "0.0",
        "deposit_id": "deposit_123",
        "created_at": "2024-01-01T00:00:00.000Z",
        "destination_tx_hash": "0xdeadbeef",
        "source": {
          "payment_rail": "ach_push",
          "description": "ACH description",
          "sender_name": "The name of the business or individual who initiated the ACH",
          "sender_bank_routing_number": "The routing number of the entity that initiated this ACH transaction",
          "trace_number": "The unique, a 15-digit number associated with each ACH transaction that is used for tracking and reconciling transactions"
        }
      }
    },
    {
      "value": {
        "id": "va_event_123",
        "customer_id": "cust_alice",
        "virtual_account_id": "va_123",
        "type": "funds_received",
        "amount": "123.45",
        "currency": "usd",
        "developer_fee_amount": "0.0",
        "exchange_fee_amount": "0.0",
        "subtotal_amount": "123.45",
        "gas_fee": "0.0",
        "deposit_id": "deposit_123",
        "created_at": "2024-01-01T00:00:00.000Z",
        "source": {
          "payment_rail": "ach_push",
          "description": "ACH description",
          "sender_name": "The name of the business or individual who initiated the ACH",
          "sender_bank_routing_number": "The routing number of the entity that initiated this ACH transaction",
          "trace_number": "The unique, a 15-digit number associated with each ACH transaction that is used for tracking and reconciling transactions"
        }
      }
    },
    {
      "value": {
        "id": "va_event_789",
        "customer_id": "cust_alice",
        "virtual_account_id": "va_456",
        "type": "payment_processed",
        "amount": "123.45",
        "currency": "usdc",
        "developer_fee_amount": "0.0",
        "exchange_fee_amount": "0.0",
        "subtotal_amount": "123.45",
        "gas_fee": "0.0",
        "deposit_id": "deposit_789",
        "created_at": "2025-06-01T00:00:00.000Z",
        "source": {
          "payment_rail": "spei",
          "description": "Receiving CLABE | clave de rastreo | SPEI reference",
          "tracking_number": "The unique tracking number or clave de rastreo for this SPEI transaction",
          "sender_name": "The name of the business or individual who initiated the SPEI credit",
          "reference": "The reference or concepto de pago for this SPEI transaction"
        }
      }
    }
  ]
}

Authorizations

​
Api-Key
string
header
required

Query Parameters

​
tx_hash
string

The hash of the transaction

​
limit
integer

The number of items to return (default of 10, max of 100)

​
starting_after
string

This is an event id. If this is specified, the next page that starts with an event right AFTER the specified event id on the event timeline, which is always ordered from the newest to the oldest by creation time, will be returned. This also implies that events older than the specified event id will be returned (shouldn't be set if ending_before is set)

​
ending_before
string

This is an event id. If this is specified, the previous page that ends with an event right BEFORE the specified event id on the event timeline, which is always ordered from the newest to the oldest by creation time, will be returned. This also implies that events newer than the specified event id will be returned (shouldn't be set if starting_after is set)

​
event_type
enum<string>

Filter history by event type

Available options:
funds_received,
payment_submitted,
payment_processed,
in_review,
refund,
microdeposit,
account_update,
deactivation,
activation
​
updated_after_ms
integer

This is a unix timestamp in milliseconds. If this is specified, objects updated AFTER the specified timestamp will be returned

​
updated_before_ms
integer

This is a unix timestamp in milliseconds. If this is specified, objects updated BEFORE the specified timestamp will be returned

Response

200 - application/json

List of Virtual Account events

The response is of type object.