Retrieve transaction history
Understand how to retrieve the transaction history for a user's account. This guide explains how to fetch a list of all ledger activities, including credits, debits, and transfers, for reconciliation and display.
The history of transactions can be retrieved at the account level or on the card level. These transactions are records of each debit and credit made against the payment instrument — wallet or card.
Note:
The transaction history of the User's Account or Card can be retrieved with records not older than 90 days.
Wallet Transaction History
Wallet transaction history will include all closed-loop fund movements against the account/wallet. It will also keep track of all transactions involving open-loop card debits and credits.
Call Get Wallet Transactions (GET /users/wallets/transactions) to retrieve the list of transactions that happened against the user's wallet.
Get Wallet Transactions request
CURL
curl --location 'https://{{accounts_base_url}}/{{program_code}}/v1/users/wallets/transactions/{{page}}?limit={{records_per_page}}' \
--header 'X-Auth-User-ID: {{user_id}}' \
--header 'Authorization: ••••••' Get Wallet Transactions response
JSON
{
"transactions": [
{
"id": "4b3aca3d5e491eba944583450820d7fc",
"type": "Money Transfer Debit",
"amount": "1.00",
"balance": "93.01",
"currency": "USD",
"status": "Success",
"description": "ACTIVE",
"indicator": "debit",
"date": "2026-01-23T13:32:06+08:00",
"details": {
"is_custom_ref_id": "0",
"name": "money transfers",
"notification": false,
"parameters": {
"amount": "1.00",
"details": {
"reason": "p2p_transfer",
"reference": "AAAAAAAAAAAAA"
},
"email": "joe.smith@matchmove.com",
"transfer_type": "send money",
"source_currency": "USD",
"destination_currency": "USD",
"fund_category_id": "1",
"fund_category_name": "DEFAULT",
"amount_points": "1.00"
},
"reason": "p2p_transfer",
"receiver": "joe.smith@matchmove.com",
"reference": "AAAAAAAAAAAA",
"transaction_currency": "USD",
"transfer_type": "send money"
},
"source": {
"id": "7d02bfc0be47de72de5a61438ee31fb7",
"number": "6377021205421785",
"payment_instrument_type": "wallet"
},
"destination": {
"id": "77bbb79267c4e6fe498ee4ccc4d3a577",
"number": "6377021205047671",
"payment_instrument_type": "wallet"
}
},
{
"id": "293a62a8767839a5788f802b637e47d2",
"type": "Money Transfer Debit",
"amount": "10.00",
"balance": "94.01",
"currency": "USD",
"status": "Success",
"description": "ACTIVE",
"indicator": "debit",
"date": "2026-01-22T19:07:04+08:00",
"details": {
"is_custom_ref_id": "0",
"name": "money transfers",
"notification": false,
"parameters": {
"amount": "10.00",
"details": {
"reason": "p2p_transfer",
"reference": "test"
},
"email": "test@matchmove.com",
"transfer_type": "send money",
"source_currency": "USD",
"destination_currency": "USD",
"fund_category_id": "1",
"fund_category_name": "DEFAULT",
"amount_points": "10.00"
},
"reason": "p2p_transfer",
"receiver": "test@matchmove.com",
"reference": "test",
"transaction_currency": "USD",
"transfer_type": "send money"
},
"source": {
"id": "7d02bfc0be47de72de5a61438ee31fb7",
"number": "6377021205421785",
"payment_instrument_type": "wallet"
},
"destination": {
"id": "c7e5e3cdbd4ab6ce9e284d3355180f23",
"number": "6377021205083031",
"payment_instrument_type": "wallet"
}
},
{
"id": "a697e643bd46ecc5919694cb2d3b7235",
"type": "Cross Border Payout Fee",
"amount": "5.05",
"balance": "104.01",
"currency": "USD",
"status": "Success",
"description": "ACTIVE",
"indicator": "debit",
"date": "2026-01-21T20:33:39+08:00",
"details": {
"id": "T5EREdDOxgDO5kDO2cTMtklTDV0TSd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful transaction",
"source": [],
"recipient": {
"id": "0a08ee09721446fdb2a5ad071067fc36",
"country": "USA",
"currency": "USD",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "ABACUS FEDERAL SAVINGS BANK",
"receiving_institution_code": "226072870",
"account_name": "Joe Smith",
"account_number": "82889128",
"account_type": "Savings Account"
},
"quote": {
"id": "5IETKVVM5cDO5kDO2cTMtklTDV0TSd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": true,
"fixed_amount": {
"currency": "USD",
"amount": "5.00"
},
"percentage_value": "0.050000000",
"percentage_amount": {
"currency": "USD",
"amount": "0.05"
},
"total": {
"currency": "USD",
"amount": "5.05"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "USD",
"amount": "5.00"
},
"percentage_value": "0.050000000",
"percentage_amount": {
"currency": "USD",
"amount": "0.05"
},
"total": {
"currency": "USD",
"amount": "5.05"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "USD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "USD",
"amount": "0.00"
},
"total": {
"currency": "USD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "USD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "USD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "1.000000000",
"details": {
"platform_rate": "1.000000000",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.000000000"
}
}
},
"charged_amount": {
"currency": "USD",
"amount": "100.00"
},
"converted_amount": {
"currency": "USD",
"amount": "94.95"
},
"recipient_amount": {
"currency": "USD",
"amount": "94.95"
},
"additional_data": {
"purpose_of_payment": "Household Maintenance",
"user_occupation": "",
"user_recipient_relationship": "",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "0001-01-01 00:00:00",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "1.97.48.204",
"tos_acceptance_user_agent": "Mozilla/5.0 (iPad; CPU OS 18_1_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/143.0.7499.92 Mobile/15E148 Safari/604.1",
"tos_acceptance_service_agreement": ""
},
"remarks": "LOCAL-218-20260121-760402",
"created_by": "fdab36e9e1ed4a4a9a191ffa7c2cfbc4",
"created_at": "2026-01-21T20:33:38 +08:00",
"updated_at": "2026-01-21T20:33:48 +08:00"
}
},
{
"id": "adf66b0429c88653572f84a69eb90b9f",
"type": "Cross Border Payout",
"amount": "94.95",
"balance": "109.06",
"currency": "USD",
"status": "Success",
"description": "ACTIVE",
"indicator": "debit",
"date": "2026-01-21T20:33:39+08:00",
"details": {
"id": "T5EREdDOxgDO5kDO2cTMtklTDV0TSd0Ut4EWUB",
"status": "SUCCESS",
"sub_status": "TRANSACTION_SUCCESS",
"message": "Payment responds with successful transaction",
"source": [],
"recipient": {
"id": "0a08ee09721446fdb2a5ad071067fc36",
"country": "USA",
"currency": "USD",
"type": "INDIVIDUAL"
},
"receiving_institution": {
"receiving_institution_type": "BANK",
"receiving_institution": "ABACUS FEDERAL SAVINGS BANK",
"receiving_institution_code": "226072870",
"account_name": "jie luo",
"account_number": "82889128",
"account_type": "Savings Account"
},
"quote": {
"id": "5IETKVVM5cDO5kDO2cTMtklTDV0TSd0Ut8UVRB",
"type": "FORWARD",
"status": "CONSUMED",
"fees": {
"included": true,
"fixed_amount": {
"currency": "USD",
"amount": "5.00"
},
"percentage_value": "0.050000000",
"percentage_amount": {
"currency": "USD",
"amount": "0.05"
},
"total": {
"currency": "USD",
"amount": "5.05"
},
"details": {
"platform_charge": {
"fixed_amount": {
"currency": "USD",
"amount": "5.00"
},
"percentage_value": "0.050000000",
"percentage_amount": {
"currency": "USD",
"amount": "0.05"
},
"total": {
"currency": "USD",
"amount": "5.05"
}
},
"markup": {
"program": {
"fixed_amount": {
"currency": "USD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "USD",
"amount": "0.00"
},
"total": {
"currency": "USD",
"amount": "0.00"
}
},
"total_markup": {
"fixed_amount": {
"currency": "USD",
"amount": "0.00"
},
"percentage_value": "0.000000000",
"percentage_amount": {
"currency": "USD",
"amount": "0.00"
}
}
}
}
},
"fx_rate": {
"value": "1.000000000",
"details": {
"platform_rate": "1.000000000",
"markup": {
"partner": "0.000000000",
"total": "0.000000000"
},
"net_markup": "0.000000000"
}
}
},
"charged_amount": {
"currency": "USD",
"amount": "100.00"
},
"converted_amount": {
"currency": "USD",
"amount": "94.95"
},
"recipient_amount": {
"currency": "USD",
"amount": "94.95"
},
"additional_data": {
"purpose_of_payment": "Household Maintenance",
"user_occupation": "",
"user_recipient_relationship": "",
"user_source_of_income": ""
},
"tos": {
"tos_acceptance_date": "0001-01-01 00:00:00",
"tos_acceptance_device_id": "",
"tos_acceptance_ip": "1.97.48.204",
"tos_acceptance_user_agent": "Mozilla/5.0 (iPad; CPU OS 18_1_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/143.0.7499.92 Mobile/15E148 Safari/604.1",
"tos_acceptance_service_agreement": ""
},
"remarks": "LOCAL-218-20260121-760402",
"created_by": "fdab36e9e1ed4a4a9a191ffa7c2cfbc4",
"created_at": "2026-01-21T20:33:38 +08:00",
"updated_at": "2026-01-21T20:33:48 +08:00"
}
},
{
"id": "337f3701713f68646879efc3b0e31e3d",
"type": "Money Transfer Debit",
"amount": "10.00",
"balance": "204.01",
"currency": "USD",
"status": "Success",
"description": "ACTIVE",
"indicator": "debit",
"date": "2026-01-21T20:31:20+08:00",
"details": {
"is_custom_ref_id": "0",
"name": "money transfers",
"notification": false,
"parameters": {
"amount": "10.00",
"details": {
"reason": "p2p_transfer"
},
"email": "joe.smith@matchmove.com",
"transfer_type": "send money",
"source_currency": "USD",
"destination_currency": "USD",
"fund_category_id": "1",
"fund_category_name": "DEFAULT",
"amount_points": "10.00"
},
"reason": "p2p_transfer",
"receiver": "joe.smith@matchmove.com",
"transaction_currency": "USD",
"transfer_type": "send money"
},
"source": {
"id": "7d02bfc0be47de72de5a61438ee31fb7",
"number": "6377021205421785",
"payment_instrument_type": "wallet"
},
"destination": {
"id": "77bbb79267c4e6fe498ee4ccc4d3a577",
"number": "6377021205047671",
"payment_instrument_type": "wallet"
}
}
],
"records_per_page": 5,
"page": 1,
"total_records": 5
}Card Transaction History
Card transaction history only records the transactions made against cards, and every authorized transaction requires consumption of the wallet balance. Therefore, every authorized card transaction will be accompanied by its respective wallet transaction for the consumption of the wallet balance.
Call Get Card Transactions (GET /users/wallets/cards/transactions) to retrieve the list of transactions that happened against a specific user's card.
Get Card Transactions request
CURL
curl --location 'https://{{accounts_base_url}}/{{program_code}}/v1/users/wallets/cards/31b5d57549de6210e2fa237492d6ce60/transactions/{{page}}?limit={{records_per_page}}' \
--header 'X-Auth-User-ID: {{user_id}}' \
--header 'Authorization: ••••••' Get Card Transactions response
JSON
{
"transactions": [
{
"id": "CV_4b9407d51cd8403b988c1398bf21915a",
"type": "Credit Voucher",
"amount": "0.12",
"balance": "488.57",
"currency": "SGD",
"status": "Success",
"description": "SETTLED",
"indicator": "credit",
"date": "2025-09-02T19:30:08+08:00",
"details": {
"name": "transaction authorizations",
"transaction_currency": "SGD",
"merchant_name": "Test Account SGP",
"merchant_category_code": "5962",
"merchant_location": "",
"terminal_id": "TEST1234",
"original_transaction_currency": "SGD",
"original_transaction_amount": "0.12",
"total_fees_charged": "0.00",
"total_fees_currency": "SGD",
"total_transaction_amount": "0.12",
"total_transaction_currency": "SGD",
"transaction_mode": "ECOM",
"transaction_network": "Master",
"additional_details": {
"AAV": "",
"CSC": ""
}
}
},
{
"id": "NAS_96f839a5148548a098a91025691c4d74",
"type": "No Auth Settlement",
"amount": "1.40",
"balance": "488.45",
"currency": "SGD",
"status": "Success",
"description": "SETTLED",
"indicator": "debit",
"date": "2025-09-02T19:30:04+08:00",
"details": {
"name": "transaction authorizations",
"transaction_currency": "SGD",
"merchant_name": "FACEBK ADS fb.me ads SGP",
"merchant_category_code": "6012",
"merchant_location": "",
"terminal_id": "TEST1234",
"original_transaction_currency": "SGD",
"original_transaction_amount": "1.40",
"total_fees_charged": "0.00",
"total_fees_currency": "SGD",
"total_transaction_amount": "1.40",
"total_transaction_currency": "SGD",
"transaction_mode": "ECOM",
"transaction_network": "Master",
"additional_details": {
"AAV": "",
"CSC": ""
}
}
},
{
"id": "P_446a284c393a49c5aa6676d9c2cbf98b",
"type": "Purchase",
"amount": "0.10",
"balance": "489.85",
"currency": "SGD",
"status": "Success",
"description": "SETTLED",
"indicator": "debit",
"date": "2025-09-02T19:29:53+08:00",
"details": {
"name": "transaction authorizations",
"transaction_currency": "SGD",
"merchant_name": "TEST ACCOUNT SGP",
"merchant_category_code": "6012",
"merchant_location": "PHL",
"terminal_id": "TEST1234",
"original_transaction_currency": "SGD",
"original_transaction_amount": "0.10",
"total_fees_charged": "0.00",
"total_fees_currency": "SGD",
"total_transaction_amount": "0.10",
"total_transaction_currency": "SGD",
"transaction_mode": "ECOM",
"transaction_network": "Master",
"additional_details": {
"AAV": "",
"CSC": ""
}
}
},
{
"id": "P_06836f92666b43be9805a441fda858e0",
"type": "Authorization Released",
"amount": "0.10",
"balance": "489.95",
"currency": "SGD",
"status": "Success",
"description": "REVERSED",
"indicator": "credit",
"date": "2025-09-02T19:29:41+08:00",
"details": {
"name": "transaction authorizations",
"transaction_currency": "SGD",
"merchant_name": "TEST ACCOUNT SGP",
"merchant_category_code": "6012",
"merchant_location": "PHL",
"terminal_id": "TEST1234",
"original_transaction_currency": "SGD",
"original_transaction_amount": "0.10",
"total_fees_charged": "0.00",
"total_fees_currency": "SGD",
"total_transaction_amount": "0.10",
"total_transaction_currency": "SGD",
"transaction_mode": "ECOM",
"transaction_network": "Master",
"additional_details": {
"AAV": "",
"CSC": ""
},
"date_reversed": "2025-09-02T19:29:41+08:00"
}
},
{
"id": "P_06836f92666b43be9805a441fda858e0",
"type": "Purchase",
"amount": "0.10",
"balance": "489.85",
"currency": "SGD",
"status": "Success",
"description": "SETTLED",
"indicator": "debit",
"date": "2025-09-02T19:29:38+08:00",
"details": {
"name": "transaction authorizations",
"transaction_currency": "SGD",
"merchant_name": "TEST ACCOUNT SGP",
"merchant_category_code": "6012",
"merchant_location": "PHL",
"terminal_id": "TEST1234",
"original_transaction_currency": "SGD",
"original_transaction_amount": "0.10",
"total_fees_charged": "0.00",
"total_fees_currency": "SGD",
"total_transaction_amount": "0.10",
"total_transaction_currency": "SGD",
"transaction_mode": "ECOM",
"transaction_network": "Master",
"additional_details": {
"AAV": "",
"CSC": ""
}
}
}
],
"records_per_page": 5,
"page": 1,
"total_records": 5
}}Card Transaction Types (transaction.type)
PurchaseCash WithdrawalPurchase ReversalATM Balance Inquiry FeeATM Cash Withdrawal FeeBalance Inquiry FeeCross Border Cross Currency FeeCross Border FeeCross Currency FeeATM Balance Inquiry Fee ReversalATM Cash Withdrawal Fee ReversalCross Border Fee ReversalCross Currency Fee ReversalATM Balance InquiryBalance InquiryATM Balance Inquiry ReversalCredit VoucherAuthorization ReleasedIssuer Forex Fee ReversalCash Withdrawal ReversalMismatch ReversalMismatch DebitNo Auth SettlementIssuer SurchargeIssuer Surcharge ReversalAccount VerificationAccount Verification Reversal
Related Links
Was this section helpful?
On this page
- Retrieve transaction history