Virtual Account Services
  1. Dashboard
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
    • Get Invoice Detail
    • List Merchant Invoices
  • 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
        GET
      • Dashboard Transactions
        GET
      • Dashboard Transaction Details
        GET
    • 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. Dashboard

Dashboard Transactions

GET
/admin/dashboard/transactions
This API provides a comprehensive overview of transactions for the admin dashboard. It returns detailed information about each transaction. This information is crucial for real-time monitoring and operational oversight of financial activities.

Response Body#

The response is a JSON array of transaction objects. Each transaction object includes the following fields:
Field NameData TypeDescription
transactionTypestringThe type of transaction (e.g., CREDIT or DEBIT).
amountnumberThe monetary amount of the transaction.
narrationstringA brief description or note associated with the transaction.
classificationCodestringA code used to categorize the transaction.
successbooleanIndicates whether the transaction was successfully processed (true or false).
traceIDstringA unique identifier used for tracking and tracing the transaction.
transactionReferencestringA unique reference assigned to the transaction.
totalChargesnumberThe total charges applied to the transaction, if any.
accountNamestringThe name of the account associated with the transaction.
accountIDstringThe unique identifier of the account involved in the transaction.
transactionTimestringThe timestamp of when the transaction occurred (in ISO 8601 format).

Request

Query Params

Request Code 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 '/admin/dashboard/transactions?page=1&items=500&noOfDays=30'

Responses

🟢200Dashboard Transactions [With Options]
application/json
Body

Example
[
    {
        "transactionType": "CREDIT",
        "amount": 5100,
        "narration": "FBNMOBILE:IRECHARGE   241115531119/BUY POWER",
        "classificationCode": "NIP0001_CREDIT",
        "success": true,
        "traceID": "bf7689cd-4f65-413f-968f-347ae883e4ba",
        "transactionReference": "000016241206124123000043698487",
        "totalCharges": 0,
        "accountName": "iRecharge",
        "accountID": "1110001455",
        "transactionTime": "2024-12-06T11:41:46.000+00:00"
    },
    {
        "transactionType": "DEBIT",
        "amount": 2000,
        "narration": "iRecharge",
        "classificationCode": "SUBLEDGER_DEBIT",
        "success": true,
        "traceID": "d5f56a64-6dda-4126-9325-30c81c397188",
        "transactionReference": "7f5e9f57411a4c6b99b5446186ddbaae",
        "totalCharges": 0,
        "accountName": "iRecharge Tech-Innovations LTD",
        "accountID": "9900000839",
        "transactionTime": "2024-12-06T11:31:13.000+00:00"
    },
    {
        "transactionType": "DEBIT",
        "amount": 1,
        "narration": "Adept Settlement - hammer schoolsssssssyyy",
        "classificationCode": "SUBLEDGER_DEBIT",
        "success": true,
        "traceID": "f659e575-6438-485a-99ae-5157bb706f6c",
        "transactionReference": "77f4304fe51047839a57a1fda07b77d1",
        "totalCharges": 0,
        "accountName": "hammer schoolsssssss",
        "accountID": "9900004875",
        "transactionTime": "2024-12-06T10:59:02.000+00:00"
    },
    {
        "transactionType": "DEBIT",
        "amount": 0,
        "narration": "Adept Settlement - hammer schoolsssssssyyy",
        "classificationCode": "ADEPT_SETTLEMENT",
        "success": true,
        "traceID": "0d6f0dc2-41c3-4375-8e65-d7414aa5e34e",
        "transactionReference": "ADEPT_SETTLEMENT_6180",
        "totalCharges": 0,
        "accountName": "hammer schoolsssssss",
        "accountID": "9900004875",
        "transactionTime": "2024-12-06T10:59:00.000+00:00"
    },
    {
        "transactionType": "CREDIT",
        "amount": 1,
        "narration": "Adept Settlement - Hero International Schools",
        "classificationCode": "ADEPT_SETTLEMENT_REVERSAL",
        "success": true,
        "traceID": "91bf0c24-aa9b-45bf-8ffc-4a715ab7b083",
        "transactionReference": "ADEPT_SETTLEMENT_6177",
        "totalCharges": 0,
        "accountName": "Hero International Schools",
        "accountID": "9900006817",
        "transactionTime": "2024-12-06T10:58:53.000+00:00"
    },
    {
        "transactionType": "DEBIT",
        "amount": 1,
        "narration": "Adept Settlement - Hero International Schools",
        "classificationCode": "ADEPT_SETTLEMENT",
        "success": true,
        "traceID": "2b244562-43c8-47e9-a424-b79034ce64f1",
        "transactionReference": "ADEPT_SETTLEMENT_6175",
        "totalCharges": 0,
        "accountName": "Hero International Schools",
        "accountID": "9900006817",
        "transactionTime": "2024-12-06T10:58:49.000+00:00"
    },
    {
        "transactionType": "CREDIT",
        "amount": 30,
        "narration": "Adept Settlement - Akbar Academy ",
        "classificationCode": "ADEPT_SETTLEMENT_REVERSAL",
        "success": true,
        "traceID": "e7e49d61-a3f0-4bfe-94dc-e770c014b03c",
        "transactionReference": "ADEPT_SETTLEMENT_6172",
        "totalCharges": 0,
        "accountName": "Akbar Academy ",
        "accountID": "5550005334",
        "transactionTime": "2024-12-06T10:58:40.000+00:00"
    },
    {
        "transactionType": "DEBIT",
        "amount": 30,
        "narration": "Adept Settlement - Akbar Academy ",
        "classificationCode": "ADEPT_SETTLEMENT",
        "success": true,
        "traceID": "f455ac5d-0feb-466b-b4b9-4ae659d2fee5",
        "transactionReference": "ADEPT_SETTLEMENT_6170",
        "totalCharges": 0,
        "accountName": "Akbar Academy ",
        "accountID": "5550005334",
        "transactionTime": "2024-12-06T10:58:34.000+00:00"
    },
    {
        "transactionType": "CREDIT",
        "amount": 1000,
        "narration": "NIP Transfer to KEDCO Prepaid - 62320111941. 000013241206115611000014869062",
        "classificationCode": "NIP0001_CREDIT",
        "success": true,
        "traceID": "cddb5696-285a-483c-b04c-fef59b2b84b6",
        "transactionReference": "000013241206115611000014869062",
        "totalCharges": 0,
        "accountName": "KEDCO Prepaid - 62320111941",
        "accountID": "9900113672",
        "transactionTime": "2024-12-06T10:56:21.000+00:00"
    },
    {
        "transactionType": "DEBIT",
        "amount": 8000,
        "narration": "iRecharge",
        "classificationCode": "SUBLEDGER_DEBIT",
        "success": true,
        "traceID": "6318f5da-bf7a-48b4-aa0c-3d811f78054b",
        "transactionReference": "f530c78cc8b949bdb19b0650ed33d54a",
        "totalCharges": 0,
        "accountName": "iRecharge Tech-Innovations LTD",
        "accountID": "9900000839",
        "transactionTime": "2024-12-06T10:55:20.000
Modified at 2025-02-27 09:49:33
Previous
Dashboard Summary
Next
Dashboard Transaction Details
Built with