List Wallet Transactions

Retrieve a list of all transactions related to a wallet.

The response fields vary depending on the type of the transaction. See Transaction Types.

Note

This endpoint replaces the deprecated endpoint - GET /v1/user/:wallet/transactions

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

Parameters

Request Path Parameters

ewallet
ID of the wallet. String starting with ewallet_.

Request Query Parameters

- balance
- The updated wallet balance after successful completion of the transaction.
- currency
- Three-letter ISO 4217 code for the currency of the transactions.
- end_date
- Timestamp of the last transaction, in Unix time.
- ending_before
- The ID of the wallet transaction created after the last wallet transaction you want to retrieve. String starting with wt_.
- page_number
- Page number to retrieve.
- page_size
- Number of results per page.
- start_date
- Timestamp of the first transaction, in Unix time.
- starting_after
- The ID of the wallet transaction created before the first wallet transaction you want to retrieve. String starting with wt_.
- type
- Type of transaction.

Request Header Parameters

Response Parameters

- amount
- Amount of the transaction, in units of the currency defined in currency. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 4217:2015.
- balance
- Amount of the balance affected by the transaction.
- balance_type
- Type of the currency account balance of the wallet affected by the transaction. See Wallet Balance Types.
- created_at
- Time the transaction was made, in Unix time.
- currency_code
- Three-letter ISO 4217 code for the currency used in the amount field.
- destination_balance_type
- Type of the currency account balance of the wallet receiving the money. See Wallet Balance Types.
- destination_ewallet_id
- ID of the wallet receiving the money. String starting with ewallet_.
- destination_phone_number
- Phone number of the owner of the wallet receiving the money, in E.164 format.
- destination_transaction_id
- ID of the transaction with regard to the destination. String starting with wt_.
- ewallet_id
- ID of the affected wallet. String starting with ewallet_.
- id
- ID of the transaction. UUID.
- metadata
- A JSON object defined by the client. See Metadata.
- reason
- Reason for the transaction.
- response_metadata
- Metadata created with Set Transfer Response.
- source_balance_type
- Type of the currency account balance of the wallet sending the money. See Wallet Balance Types.
- source_ewallet_id
- ID of the wallet sending the money. String starting with ewallet_.
- source_transaction_id
- ID of the transaction with regard to the source. String starting with wt_.
- status
- Status of the transaction.
  - CAN - Canceled. The transferor canceled the transfer.
  - CLO - Closed. The transferee accepted the funds.
  - DEC - Declined. The transferee rejected the transfer.
  - EXP - Expired. The transferee did not respond before the transfer expired.
  - HLD - Hold. Rapyd Protect is putting this transfer on hold and reviewing it.
  - PEN - Pending. Waiting for the transferee to accept.
  - REJ - Rejected. Rapyd Protect has rejected this transfer.
- subtype
- Subtype of the transaction.
- transfer_response_at
- Time of the Set Transfer Response operation, in Unix time.
- type
- Transaction type. See Transaction Types.

Code Samples

.NET

using System;

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

                string result = RapydApiRequestSample.Utilities.MakeRequest("GET", $"/v1/user/{wallet}/transactions");

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

JavaScript

const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

async function main() {
  try {
    const result = await makeRequest(
      'GET',
      '/v1/user/ewallet_5d228399661dac92968ace74f7aa00c6/transactions'
    );
    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

PHP

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/<path-to-your-utility-file>/utilities.php";
include($path);

try {
    $object = make_request('get', '/v1/user/ewallet_5d228399661dac92968ace74f7aa00c6/transactions');
    var_dump($object);
} catch(Exception $e) {
    echo "Error: $e";
}
?>

Python

from pprint import pprint

from utilities import make_request

wallet = 'ewallet_5d228399661dac92968ace74f7aa00c6'
results = make_request(method='get', path=f'/v1/user/{wallet}/transactions')

pprint(results)

/v1/ewallets/:ewallet/transactions

List Wallet Transactions

curl -X get
https://sandboxapi.rapyd.net/v1/ewallets/ewallet_9fa604317114b2c0d5ae0599f9eabdf6/transactions
-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": "eb6aa4e3-24ba-4516-9ca4-f2b5036bd12e"
    },
    "data": [
        {
            "id": "wt_66717bc2532641d51a653b4a59463a4a",
            "currency": "USD",
            "amount": -18,
            "ewallet_id": "ewallet_9fa604317114b2c0d5ae0599f9eabdf6",
            "type": "balance_transfer",
            "subtype": null,
            "balance_type": "available_balance",
            "balance": 550050855.93,
            "destination_ewallet_id": "ewallet_56e3911e5fec5db8e0a36e1212bf4576",
            "destination_balance_type": "received_balance",
            "created_at": 1706685621,
            "status": "CLOSED",
            "reason": "",
            "metadata": {}
        },
        {
            "id": "wt_80f5118850d40c3f7cf8154546fa9323",
            "currency": "USD",
            "amount": -18,
            "ewallet_id": "ewallet_9fa604317114b2c0d5ae0599f9eabdf6",
            "type": "balance_transfer",
            "subtype": "monthly_user_wallets_fee",
            "balance_type": "available_balance",
            "balance": 550050873.93,
            "destination_ewallet_id": "ewallet_56e3911e5fec5db8e0a36e1212bf4576",
            "destination_balance_type": "received_balance",
            "created_at": 1706673447,
            "status": "CLOSED",
            "reason": "",
            "metadata": {}
        }
    ]
}

List Wallet Transactions by Type

curl -X get
https://sandboxapi.rapyd.net/v1/ewallets/ewallet_9fa604317114b2c0d5ae0599f9eabdf6/transactions?type=balance_transfer
-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": "eb6aa4e3-24ba-4516-9ca4-f2b5036bd12e"
    },
    "data": [
        {
            "id": "wt_66717bc2532641d51a653b4a59463a4a",
            "currency": "USD",
            "amount": -18,
            "ewallet_id": "ewallet_9fa604317114b2c0d5ae0599f9eabdf6",
            "type": "balance_transfer",
            "subtype": null,
            "balance_type": "available_balance",
            "balance": 550050855.93,
            "destination_ewallet_id": "ewallet_56e3911e5fec5db8e0a36e1212bf4576",
            "destination_balance_type": "received_balance",
            "created_at": 1706685621,
            "status": "CLOSED",
            "reason": "",
            "metadata": {}
        },
        {
            "id": "wt_80f5118850d40c3f7cf8154546fa9323",
            "currency": "USD",
            "amount": -18,
            "ewallet_id": "ewallet_9fa604317114b2c0d5ae0599f9eabdf6",
            "type": "balance_transfer",
            "subtype": "monthly_user_wallets_fee",
            "balance_type": "available_balance",
            "balance": 550050873.93,
            "destination_ewallet_id": "ewallet_56e3911e5fec5db8e0a36e1212bf4576",
            "destination_balance_type": "received_balance",
            "created_at": 1706673447,
            "status": "CLOSED",
            "reason": "",
            "metadata": {}
        }
    ]
}

In this section:

Documentation