Retrieve Virtual Account History

Retrieve a Virtual Account Number object for a wallet.

This object contains a list of all the transactions involving the virtual account number.

Note

This endpoint replaces the deprecated endpoint GET /v1/issuing/bankaccounts/:virtual_account

Rapyd will continue to support the deprecated endpoint until December 31, 2024.

Parameters

Request Path Parameters

- virtual_account
- ID of the Virtual Account. String starting with issuing_.

Request Header Parameters

Response Parameters

- id
- ID of the virtual account. String starting with issuing_.
- bank_account
- Details about the virtual account, including the following fields:
  aba
  9-digit ABA routing number of the virtual account.
  aba_routing_number
  9-digit ABA routing number of the virtual account.
  account_holder
  Name of the virtual account holder.
  account_no
  The actual account number that was assigned to the virtual account when it was created.
  account_number
  The actual account number that was assigned to the virtual account when it was created.
  address
  Street address of the branch of the bank that issued the virtual account number.
  beneficiary_name
  Name of the owner of the Rapyd Wallet that the virtual account number was issued to.
  bic
  Bank Identifier Code (BIC) of the virtual account.
  branch_code
  Number of the bank branch.
  city
  City of the branch of the bank that issued the virtual account number.
  country
  Two-letter ISO 3166-1 ALPHA-2 code of the country of the virtual account.
  country_iso
  Two-letter ISO 3166-1 ALPHA-2 code of the country of the virtual account.
  iban
  International bank account number (IBAN) of the virtual account.
  payment_type
  Method of transferring funds to and from the virtual account.
  sort_code
  A six-digit bank identification number. Relevant to certain country-currency combinations.
- currency
- Currency of the virtual account. Three-letter ISO 4217 code.
- description
- Description of the virtual account when it was created, as defined by the client.
- ewallet
- ID of the Rapyd Wallet that the virtual account is attached to. String starting with ewallet_.
- funding_instructions
- Reserved.
- merchant_reference_id
- Identifier defined by the client for reference purposes. Limit: 45 characters.
- metadata
- A JSON object defined by the client. See Metadata.
- partner_transaction_id
- ID that is assigned by the client to the transaction.
- requested_currency
- Currency received by the virtual account after conversion. One of the following:
  AUD - Australian Dollar
  EUR - Euro
  GBP - Pound Sterling
  HKD - Hong Kong Dollar
  SGD - Singapore Dollar
  USD - US Dollar
- status
- Indicates the status of the virtual account.
  - ACT - Active.
  - ERR - Error.
  - PEN - Pending.
  - REJ - Rejected.
- transactions
- List of individual transactions in the wallet that were done via the virtual account number. Array of objects. Each object has the following fields:
  id
  ID of the transaction. String starting with isutran_.
  amount
  The amount credited to the virtual account, in units of the currency defined in currency.
  created_at
  Timestamp for the transaction, in Unix time.
  currency
  The currency credited to the virtual account. Three-letter ISO 4217 code.
  Transactions without FX - The currency sent by the sender.
  FX transactions - Determined by requested_currency in the virtual account.
  fx_rate
  Currency conversion rate for the transaction.
  original_amount
  The amount sent by the sender to the virtual account, in units of the currency defined in original_currency.
  original_currency
  The currency sent by the sender to the virtual account. Three-letter ISO 4217 code.

Code Samples

.NET

using System;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
             
                string virtualBankAccount = "issuing_b1dcb7ceedb740200f7656cfa191f47d";

                string result = RapydApiRequestSample.Utilities.MakeRequest("GET", $"/v1/virtual_accounts/{virtualBankAccount}");

                Console.WriteLine(result);
            }
            catch (Exception e)
            {
                Console.WriteLine("Error completing request: " + e.Message);
            }
        }
    }
}

JavaScript

const makeRequest = require('../../../../Utilities/JS/utilities').makeRequest;

async function main() {
  try {
    const result = await makeRequest(
      'GET',
      '/v1/virtual_accounts/issuing_b1dcb7ceedb740200f7656cfa191f47d'
    );

    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

PHP

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/code_race_2020/Utilities/PHP/utilities.php";
include($path);
try {
    $object = make_request('post', '/v1/virtual_accounts/issuing_b1dcb7ceedb740200f7656cfa191f47d');
    var_dump($object);
} catch(Exception $e) {
    echo "Error: $e";
}
?>

Python

from pprint import pprint

from utilities import make_request

results = make_request(method='get', path=f'/v1/virtual_accounts/issuing_b1dcb7ceedb740200f7656cfa191f47d')
pprint(results)

/v1/virtual_accounts/:virtual_account

Retrieve Virtual Account History

curl -X get
https://sandboxapi.rapyd.net/v1/virtual_accounts/issuing_36feaa027745f08b4691636d8d3fd07e
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "5d94bb3b-720e-4e59-8cce-a6051a9da2b4"
    },
    "data": {
        "id": "issuing_36feaa027745f08b4691636d8d3fd07e",
        "merchant_reference_id": "issuing_36feaa027745f08b4691636d8d3fd07e",
        "ewallet": "ewallet_5c148fcf040282f80907026f6030cce9",
        "bank_account": {
            "beneficiary_name": "Rapyd Holdings Pte Ltd",
            "address": "G/F, The Center, 99 Queen's Road Central, Central, Hong Kong",
            "country_iso": "HK",
            "bank": "DBS Bank (Hong Kong) Limited",
            "country": "Hong Kong",
            "bank_code": "016",
            "account_id": "7981397317776192",
            "account_id_type": "",
            "local_bank_code_type": "",
            "swift_bic": "DHBKHKHH",
            "branch_code": "478"
        },
        "metadata": {},
        "status": "ACT",
        "description": "K DBS HK",
        "funding_instructions": null,
        "currency": "HKD",
        "requested_currency": "USD",
        "transactions": [
            {
                "id": "isutran_1dced11bb8a6592a6261e945fd2267bc",
                "amount": 10,
                "currency": "USD",
                "original_amount": 10,
                "original_currency": "USD",
                "fx_rate": 1,
                "created_at": 1703848792
            }
        ]
    }
}

In this section:

Documentation