--- title: "Virtual Account Activity" method: GET path: "/customers/{customerID}/virtual_accounts/{virtualAccountID}/history" tags: ["Virtual Accounts"] --- # Virtual Account Activity `GET /customers/{customerID}/virtual_accounts/{virtualAccountID}/history` History of activity for a Virtual Account ## Response `200` List of Virtual Account events - object - `count` integer, required — The number of events returned - `data` VirtualAccountEvent[], required - `id` string, required — A UUID that uniquely identifies a resource - `type` 'funds_scheduled' | 'funds_received' | 'payment_submitted' | 'payment_processed' | 'in_review' | 'refund' | 'refund_in_flight' | 'refund_failed' | 'microdeposit' | 'account_update' | 'deactivation' | 'activation' — The type of activity - `customer_id` string — A UUID that uniquely identifies a resource - `virtual_account_id` string — A UUID that uniquely identifies a resource - `amount` string — Amount for that event, represented as a dollar denominated string. Examples include "100.25", "0.1", "1.234567" etc. For "incoming" events such as funds_received or under_review, this is the initial amount received. For "outgoing" events such as payment_submitted and payment_processed, this is the amount of funds sent to the destination. For non-transactional events such as account_update, this will be zero. - `currency` 'usdb' | 'usdc' | 'usdt' | 'usd' | 'pyusd' - `developer_fee_amount` string — Amount of the developer fee if any, represented as a dollar denominated string. This is the final amount taken out of what is ultimately received by your customer, not a percentage. Examples include "100.25", "0.1", "1.234567" etc. - `exchange_fee_amount` string — Amount of the exchange fee if any, represented as a dollar denominated string. Examples include "100.25", "0.1", "1.234567" etc. - `subtotal_amount` string — Amount of the subtotal, represented as a dollar denominated string. Examples include "100.25", "0.1", "1.234567" etc. - `gas_fee` string — Amount of the gas fee if any, represented as a dollar denominated string. Examples include "100.25", "0.1", "1.234567" etc. - `deposit_id` string — The id of the deposit related to this event. This id can be used to link multiple events to the same transaction. Omitted for some `refund` cases. - `destination_tx_hash` string — The hash of the on-chain transfer to the destination address - `destination_payment_rail` string — The destination payment rail where the funds are deposited to - `source` VirtualAccountEventSource - `payment_rail` 'ach_push' | 'bre_b' | 'faster_payments' | 'fednow' | 'pix' | 'sepa' | 'spei' | 'wire', required - `description` string — (ACH, SPEI, and FedNow only) The description of the deposit that the customer sent - `sender_name` string — (ACH, SEPA, SPEI, and FedNow only) The name of the business or individual who initiated the transaction - `sender_bank_routing_number` string — (ACH and FedNow only) The routing number of the entity that initiated this transaction - `end_to_end_id` string — The end-to-end ID of the FedNow transaction, assigned by the sending bank, and is not guaranteed to be unique across payments. - `trace_number` string — (ACH only) The unique, a 15-digit number associated with each ACH transaction that is used for tracking and reconciling transactions - `bank_routing_number` string — (Wire only) The routing number of the bank that sent the wire to the Virtual Account - `bank_name` string — (Wire and SPEI only) The name of the bank that sent the deposit. - `bank_code` string — (SPEI only) The bank code of the sender's bank that initiated this SPEI transaction. - `bank_beneficiary_name` string — (Wire only) The beneficiary name of this wire - `bank_beneficiary_address` string — (Wire only) The beneficiary address of this wire - `originator_name` string — (Wire only) The originator name of this wire - `originator_address` string — (Wire only) The originator address of this wire - `wire_message` string — (Wire only) The memo for this wire - `imad` string — (Wire only) The IMAD of a wire transfer, if available - `bic` string — (SEPA only) The BIC of the bank that initiated this transaction - `iban` string — (SEPA only) The full IBAN of the account that initiated this transaction - `iban_last_4` string — (SEPA only) The last 4 digits of the IBAN of the account that initiated this transaction - `clabe` string — (SPEI only) The CLABE (account number) of the account that initiated this transaction - `reference` string — A reference message to be sent with a SEPA transaction. We recommend you set a unique value to help you and your customers track payments end to end. It must be from 6 to 140 characters. The allowed characters are `a-z`, `A-Z`, `0-9`, spaces, ampersand (`&`), hyphen (`-`), full stop (`.`), and solidus (`/`). If not populated, the default value is "Payment via Bridge {unique_token}". - `tracking_number` string — (SPEI only) The clave de rastreo or tracking number of the SPEI transaction - `payment_scheme` 'sepa_credit' | 'sepa_instant' - `uetr` string — Deprecated: use tracking_number instead. The unique end-to-end transaction reference, for tracing purposes. - `created_at` string, date-time — Time of creation of the event - `receipt` Receipt - `initial_amount` string, required — The initial amount of the transfer, represented as a decimal string. Examples include "100.25", "0.1", "1.234567", "1.01" etc. It's denominated in the transfer's fiat currency (see the top-level `currency` field for more info) - `developer_fee` string, required — The fee, expressed as a decimal string, represents the amount you wish to reserve for your own account. This fee is the final amount deducted from what your customer ultimately receives, rather than a percentage. It is denominated in the transfer's fiat currency (see the top-level `currency` field for more info). - `exchange_fee` string, required — The fee, expressed as a decimal string, represents the amount Bridge charges for facilitating the transfer. This is the final amount to take out of what is ultimately received by your customer, not a percentage. It's denominated in the transfer's fiat currency (see top-level `currency` field for more info). - `subtotal_amount` string, required — The initial amount of the transfer less fixed fees (including the developer_fee and exchange_fee). Examples include "100.25", "0.1", "1.234567", "1.01" etc. It's denominated in the transfer's fiat currency (see top-level `currency` field for more info). - `remaining_prefunded_balance` string — For Prefunded Accounts, this value will represent the remaining account balance after the transfer. - `gas_fee` string — The fee, expressed as a decimal string. It's deducted from the withdrawn amount to pay for gas. Only nonzero to crypto withdrawals that cost gas (e.g. USDT), and only known when the transaction is confirmed on-chain. Will be missing if not yet known. It's denominated in the fiat currency to which the destination currency is pegged. - `final_amount` string — The final amount of the transfer, expressed as a decimal string, equal to the subtotal_amount minus any gas fees. If the gas fee is not known, this field will be missing. Examples include "100.25", "0.1", "1.234567", "1.01" etc. It's denominated in the destination currency if that is a fiat currency or the fiat currency to which the destination currency is pegged. - `source_tx_hash` unknown - `destination_tx_hash` unknown - `exchange_rate` unknown - `url` string — The URL of a user-facing copy of the receipt. - `bank_details` object — Bank-lookup details for fiat offramp receipts, to help the recipient's bank locate the payment. Present for enabled developers once the offramp's bank leg exists; individual fields may be null until they become available (e.g. the ACH trace ID before submission to the Fed). - `sending_routing_number` string — Routing number of the bank Bridge sent the payment from. - `ach_description` string — Statement descriptor on the outgoing ACH credit. - `ach_trace_id` string — ACH trace number, populated after submission to the Fed. - `recipient_name` string — Name on the receiving external account. - `refund` VirtualAccountRefundDetails - `code` string, required — The code of the refund - `reason` string, required — The reason of the refund - `refunded_at` string, required — The time of the refund - `risk_rejection_reason` string — If the return is due to a risk rejection, this field will be populated with the reason for the risk rejection. --- [API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/revisions/570998bde3b5/schema)