Virtual Account Services
  1. Transaction
Virtual Account Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Create Account
      POST
    • Rename Account
      POST
    • Balance Inquiry
      GET
    • Create Bulk Accounts
      POST
    • List Accounts
      GET
  • Transaction
    • Credit Account
      POST
    • Debit Account
      POST
    • Credit Account [Agency Banking]
      POST
    • Debit Account [Agency Banking]
      POST
    • Transaction Query
      GET
    • Transaction Details
      GET
    • Transaction History
      GET
  • Transfer
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • Interbank Transfer [Sync]
      POST
    • Transfer Query
      GET
    • Transfer Enquiry
      GET
    • Virtual Account Intrabank Transfer
      POST
    • Core Banking Intrabank Transfer
      POST
    • Collection Accounts Intrabank Transfer
      POST
  • Invoice
    • Create Invoice
      POST
    • Get Invoice Detail
      GET
    • List Merchant Invoices
      GET
  • Refunds
    • Initiate Refund
    • Get Refund Status
    • Get Refunds
  • Notifications
    • Notification
    • Send Notification
  • Merchant
    • Account
      • Get Account
      • Activate Sub Ledger For Merchant
      • Get SubLedger Callback Urls
      • Set SubLedger Callback Urls
      • Get Collection Accounts
    • Transfer
      • Get Transfer History
      • Get Subledger transfers
      • Get Transfer Details
      • Name Inquiry
    • Refund
      • Refund Details
  • Admin
    • Accounting
      • Get GL Accounts
      • Get Classification Codes
    • Dashboard
      • Dashboard Summary
      • Dashboard Transactions
      • Dashboard Transaction Details
    • Group Codes
      • Get Group Codes
      • Set Collection Account
      • Create Group Code
    • Reporting
      • Get Report Types
      • Get Report Parameters
      • Create Report
      • Get Reports
      • Get Reports Details
  1. Transaction

Transaction History

GET
/transactions/{accountID}
This operation fetches the transaction history for a specified accountID, providing details of past transactions.

Path Parameter#

Field NameTypeRequiredDescription
accountIDstringtrueThe unique identifier of the account whose transaction history is being queried

Response Body#

The response returns an array of objects as defined
Field NameTypeDescription
transactionTypestringThe type of transaction (e.g., DEBIT, CREDIT).
amountintegerThe amount involved in the transaction.
balb4integerThe account balance before the transaction was processed.
balAfterintegerThe account balance after the transaction was completed.
narrationstringA brief description or reason for the transaction.
classificationCodestringA code used to categorize the transaction type.
successbooleanIndicates whether the transaction was successful (true) or failed (false).
traceIDstringA unique identifier used for tracking and debugging the transaction.
transactionReferencestringA unique identifier assigned to the transaction for record-keeping.
createdOnstringThe date and time when the transaction was created.
accountIDintegerThe unique identifier of the account associated with the transaction.

Request

Path Params

Query Params

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/transactions/9900000839?startDate=29-01-2024&endDate=29-01-2024'

Responses

🟢200Transaction History
application/json
Body

Example
[
    {
        "transactionType": "DEBIT",
        "amount": 20000,
        "balb4": 4426764,
        "balAfter": 4406764,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4406764",
        "success": true,
        "traceID": "35f5b069-fedf-469f-94c7-fa5a11ee35be",
        "transactionReference": "9900000839DEBIT240129083617117",
        "createdOn": "2024-01-29T09:36:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 270,
        "balb4": 4427034,
        "balAfter": 4426764,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4426764",
        "success": true,
        "traceID": "7742809b-b8d4-4857-986a-ab7e11ad8ca5",
        "transactionReference": "9900000839DEBIT240129082547147",
        "createdOn": "2024-01-29T09:26:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 90000,
        "balb4": 4517034,
        "balAfter": 4427034,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4427034",
        "success": true,
        "traceID": "9581ad36-aae3-489c-8490-8b3d9660f3a1",
        "transactionReference": "9900000839DEBIT240129082347147",
        "createdOn": "2024-01-29T09:24:46.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 30000,
        "balb4": 4547034,
        "balAfter": 4517034,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4517034",
        "success": true,
        "traceID": "a09f817c-d24d-4f1c-8bdf-56fdfe808f0d",
        "transactionReference": "9900000839DEBIT240129081832132",
        "createdOn": "2024-01-29T09:18:46.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 800,
        "balb4": 4547834,
        "balAfter": 4547034,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4547034",
        "success": true,
        "traceID": "0558150d-4305-453c-8f63-c724d93634eb",
        "transactionReference": "9900000839DEBIT240129081221121",
        "createdOn": "2024-01-29T09:12:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 5000,
        "balb4": 4552834,
        "balAfter": 4547834,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4547834",
        "success": true,
        "traceID": "954e6dc0-3f71-4c27-b980-c73c5845cf50",
        "transactionReference": "9900000839DEBIT240129075047147",
        "createdOn": "2024-01-29T08:50:49.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 8000,
        "balb4": 4560834,
        "balAfter": 4552834,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4552834",
        "success": true,
        "traceID": "e5272af9-1c73-4f2e-944c-903cf83cceb2",
        "transactionReference": "9900000839DEBIT240129074047147",
        "createdOn": "2024-01-29T08:41:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 1050,
        "balb4": 4561884,
        "balAfter": 4560834,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4560834",
        "success": true,
        "traceID": "d3490926-4bf2-4f4d-b3ec-12d46d1e2f2c",
        "transactionReference": "9900000839DEBIT240129071653153",
        "createdOn": "2024-01-29T08:17:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 1000,
        "balb4": 4562884,
        "balAfter": 4561884,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4561884",
        "success": true,
        "traceID": "87c8d4a2-0165-4cf4-920f-9f0e2bb5e304",
        "transactionReference": "9900000839DEBIT240129070623123",
        "createdOn": "2024-01-29T08:06:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 750,
        "balb4": 4563634,
        "balAfter": 4562884,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4562884",
        "success": true,
        "traceID": "96daf83b-f85f-40fb-8fb8-5cb1f6c4e9e7",
        "transactionReference": "9900000839DEBIT240129065423123",
        "createdOn": "2024-01-29T07:54:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 3000,
        "balb4": 4566634,
        "balAfter": 4563634,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4563634",
        "success": true,
        "traceID": "6c35aec9-188f-4d04-85ea-fd6e2cb81ba5",
        "transactionReference": "9900000839DEBIT240129064153153",
        "createdOn": "2024-01-29T07:42:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 8000,
        "balb4": 4574634,
        "balAfter": 4566634,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4566634",
        "success": true,
        "traceID": "3e22d935-edaf-4264-9b6b-926863bca41a",
        "transactionReference": "9900000839DEBIT24012906380818",
        "createdOn": "2024-01-29T07:38:45.000Z",
        "accountID": "9900000839"
    },
    {
        "transactionType": "DEBIT",
        "amount": 570,
        "balb4": 4575204,
        "balAfter": 4574634,
        "narration": "TRANSFER DEBIT 9900000839",
        "classificationCode": "4574634",
        "success": true,
        "traceID": "d0c3bdbd-4646-49f5-a12a-b3e79f64b2f5",
        "transactionReference": "9900000839DEBIT240128111338138",
        "createdOn": "2024-01-29T00:13:45.000Z",
        "accountID": "9900000839"
    }
]
Modified at 2025-03-15 15:11:00
Previous
Transaction Details
Next
Get Institutions
Built with