1. Transaction
Core Banking Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Product List
      GET
    • Create Account
      POST
    • Update Account
      PUT
    • Find Client
      POST
    • Accounts
      GET
    • Create Additional Account
      POST
    • Account Details By BVN
      GET
    • Get Client Addresses
      GET
    • Get Account Details
      GET
    • Get Account Summary
      GET
    • Client Images
      GET
    • Update BVN
      POST
    • Update Transaction Limit
      POST
  • KYC
    • Get KYC Info
      POST
    • Update KYC
      POST
    • Get KYC Level
      GET
  • Transaction
    • Payment Types
      GET
    • Debit Account
      POST
    • Credit Account
      POST
    • Transaction History
      GET
    • Transaction Details [Legacy]
      GET
    • Transaction Details
      GET
  • Transfer
    • Get Institutions
    • Name Inquiry
    • Interbank Transfer
    • InterBank Transfer Query
    • Transfer Details
    • IntraBank Transfer
    • Intrabank Transfer To Virtual Accounts
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  • Schemas
    • Client
    • Product
  1. Transaction

Transaction Details

GET
/core/transactionsdetails/{transactionID}

Description#

Retrieves the details of a transaction using its unique transaction identifier.
Depending on the transaction type, the response may include transfer information such as source and destination accounts, bank information, session ID, and transaction reference.

Path Parameters#

ParameterTypeRequiredDescription
transactionIDStringYesUnique identifier of the transaction

Example URL#

Success Response#

HTTP Status#

Response Parameters#

Common Fields#

FieldTypeDescription
idIntegerInternal transaction identifier
nubanStringCustomer account number
amountNumberTransaction amount
noteStringTransaction narration
transactionTypeStringTransaction type (Deposit or Withdrawal)
balanceNumberAccount balance after the transaction (may not be returned for all transaction types)
createdDateString (ISO 8601)Date and time the transaction was created
currencyStringTransaction currency
transactionReferenceStringUnique transaction reference (available for external transfers)
transferDetailsObjectAdditional transfer information (available for transfer transactions)

Transfer Details Object#

FieldTypeDescription
amountNumberTransfer amount
typeStringTransfer type
transactionStatusStringStatus of the transfer
transactionReferenceStringTransaction reference
sessionIdStringNIP Session ID (external transfers only)
narrationStringTransaction narration
sourceAccountNUBANStringDebit account number
sourceAccountNameStringDebit account name
sourceBankNameStringDebit bank
sourceInstitutionCodeStringSource institution code (external transfers only)
destinationAccountNUBANStringCredit account number
destinationAccountNameStringCredit account name
destinationBankNameStringDestination bank
destinationInstitutionCodeStringDestination institution code (external transfers only)

Example Responses#

1. Inward Transfer#

{
  "id": 1445,
  "nuban": "0020000015",
  "amount": 20,
  "note": "Inward Test - MOHAMMED BALARABE OLATEJU",
  "transactionType": "Deposit",
  "balance": 66,
  "createdDate": "2024-10-27T06:00:48Z",
  "currency": "NGN",
  "transactionReference": "000012241027065934422656001526",
  "transferDetails": {
    "amount": 20,
    "sourceBankName": "STANBICIBTC BANK",
    "transactionStatus": "CONFIRMED",
    "transactionReference": "000012241027065934422656001526",
    "sessionId": "000012241027065934422656001526",
    "type": "INWARD_TRANSFER",
    "destinationAccountNUBAN": "0020000015",
    "destinationAccountName": "Mohammed Olateju",
    "destinationInstitutionCode": "090605",
    "sourceAccountNUBAN": "0040088210",
    "sourceAccountName": "MOHAMMED BALARABE OLATEJU",
    "sourceInstitutionCode": "0000122",
    "sourceBankName": "STANBICIBTC BANK",
    "destinationBankName": "Madobi Microfinance Bank",
    "narration": "Inward Test"
  }
}

2. Outward Transfer#

{
  "id": 1445,
  "nuban": "0020000015",
  "amount": 20,
  "note": "Outward Test - MOHAMMED BALARABE OLATEJU",
  "transactionType": "Withdrawal",
  "balance": 66,
  "createdDate": "2024-10-27T06:00:48Z",
  "currency": "NGN",
  "transactionReference": "000012241027065934422656001526",
  "transferDetails": {
    "amount": 20,
    "sourceBankName": "STANBICIBTC BANK",
    "transactionStatus": "CONFIRMED",
    "transactionReference": "000012241027065934422656001526",
    "sessionId": "000012241027065934422656001526",
    "type": "OUTWARD_TRANSFER",
    "destinationAccountNUBAN": "0020000015",
    "destinationAccountName": "Mohammed Olateju",
    "destinationInstitutionCode": "090605",
    "sourceAccountNUBAN": "0040088210",
    "sourceAccountName": "MOHAMMED BALARABE OLATEJU",
    "sourceInstitutionCode": "0000122",
    "sourceBankName": "STANBICIBTC BANK",
    "destinationBankName": "Madobi Microfinance Bank",
    "narration": "Outward Test"
  }
}

3. Intra-bank Withdrawal#

{
  "id": 35,
  "nuban": "0020000228",
  "amount": 1,
  "note": "Transfer Test",
  "transactionType": "Withdrawal",
  "createdDate": "2025-03-28T12:18:42Z",
  "currency": "NGN",
  "transferDetails": {
    "amount": 1,
    "type": "INTRABANK_TRANSFER",
    "transactionStatus": "CONFIRMED",
    "sourceBankName": "Madobi MFB",
    "sourceAccountNUBAN": "0020000228",
    "sourceAccountName": "Eyitayo Aganna",
    "destinationAccountNUBAN": "0020001050",
    "destinationAccountName": "Abigail Aina",
    "destinationBankName": "Madobi MFB",
    "narration": "Transfer Test"
  }
}

4. Intra-bank Deposit#

{
  "id": 35,
  "nuban": "0020001050",
  "amount": 1,
  "note": "Transfer Test",
  "transactionType": "Deposit",
  "createdDate": "2025-03-28T12:18:42Z",
  "currency": "NGN",
  "transferDetails": {
    "amount": 1,
    "type": "INTRABANK_TRANSFER",
    "transactionStatus": "CONFIRMED",
    "sourceBankName": "Madobi MFB",
    "sourceAccountNUBAN": "0020001050",
    "sourceAccountName": "Abigail Aina",
    "destinationAccountNUBAN": "0020000228",
    "destinationAccountName": "Eyitayo Aganna",
    "destinationBankName": "Madobi MFB",
    "narration": "Transfer Test"
  }
}

5. Withdrawal#

{
  "id": 1444,
  "nuban": "0020000015",
  "amount": 93,
  "note": "Balance - Cash",
  "transactionType": "Withdrawal",
  "balance": 46,
  "createdDate": "2024-10-27T05:50:22Z",
  "currency": "NGN"
}

6. Deposit#

{
  "id": 1444,
  "nuban": "0020000015",
  "amount": 93,
  "note": "Balance - Cash",
  "transactionType": "Deposit",
  "balance": 46,
  "createdDate": "2024-10-27T05:50:22Z",
  "currency": "NGN"
}

Transfer Types#

TypeDescription
INWARD_TRANSFERIncoming inter-bank transfer
OUTWARD_TRANSFEROutgoing inter-bank transfer
INTRABANK_TRANSFERTransfer between accounts within the same bank

Notes#

The transferDetails object is returned only for transfer transactions.
deposits and withdrawals do not include transfer details.
External (inter-bank) transfers include NIP-specific fields such as sessionId, transactionReference, and institution codes.

Request

Path Params

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 '/core/transactionsdetails/?intraBank=true'

Responses

🟢200Success
application/json
Bodyapplication/json

Examples
{
    "id": 1445,
    "nuban": "0020000015",
    "amount": 20,
    "note": "Inward Test - MOHAMMED BALARABE OLATEJU",
    "transactionType": "Deposit",
    "balance": 66,
    "createdDate": "2024-10-27T06:00:48Z",
    "currency": "NGN",
    "transactionReference": "000012241027065934422656001526",
    "transferDetails": {
        "amount": 20,
        "sourceBankName": "STANBICIBTC BANK",
        "transactionStatus": "CONFIRMED",
        "transactionReference": "000012241027065934422656001526",
        "sessionId": "000012241027065934422656001526",
        "type": "INWARD_TRANSFER",
        "destinationAccountNUBAN": "0020000015",
        "destinationAccountName": "Mohammed Olateju",
        "destinationInstitutionCode": "090605",
        "sourceAccountNUBAN": "0040088210",
        "narration": "Inward Test",
        "sourceInstitutionCode": "0000122",
        "destinationBankName": "Madobi Microfinance Bank",
        "sourceAccountName": "MOHAMMED BALARABE OLATEJU"
    }
}
Modified at 2026-08-04 04:09:17
Previous
Transaction Details [Legacy]
Next
Get Institutions
Built with