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
    • Client Notifications
      PUT
    • Activate Client Account
      POST
    • Add Client Address
      POST
    • Update Client Address
      PUT
    • Get Full Account Details
      GET
    • Get Full Account Details By NUBAN
      GET
    • Upload Client Passport
      POST
    • Update NIN
      POST
    • Create Client
      POST
    • Get Directors
      GET
    • Create Directors
      POST
    • Update Directors
      PUT
    • Delete Director
      DELETE
    • Get Genders
      GET
    • Get Signatories
      GET
    • Create Signatories
      POST
    • Delete Signatory
      DELETE
    • Get Template
      GET
  • KYC
    • Get KYC Info
    • Update KYC
    • Get KYC Level
    • Auto Verify KYC
    • Get KYC Comparison Details
    • Face Comparison
    • Get KYC Info
    • Get KYC Settings
    • Get KYC Info
    • Create Face Liveness Session
    • Get KYC Log Details
    • Get KYC Logs
    • Set KYC Level
    • Set KYC Log Status
  • Transaction
    • Payment Types
      GET
    • Debit Account
      POST
    • Credit Account
      POST
    • Transaction History
      GET
    • Transaction Details [Legacy]
      GET
    • Transaction Details
      GET
    • Get All Transactions
      GET
  • Transfer
    • Interbank Transfer
      • Get Institutions
      • Name Inquiry
      • Interbank Transfer
      • InterBank Transfer Query
      • Transfer Details
      • Bulk Interbank Transfer
    • Intrabank Transfer
      • IntraBank Transfer
      • Intrabank Transfer To Virtual Accounts
      • Query Intrabank Transfer Status
      • Intrabank Transfer To Virtual Accounts
      • Query Intrabank Transfer To Virtual Account Status
  • Account Restrictions
    • Block Debit
    • Unblock Debit
    • Hold Amount
    • Release Amount
    • Block Account
    • Block Account Credits
    • Unblock Account
    • Unblock Account Credits
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  • Organisation
    • Get Address Types
    • Get Offices
    • Get States
  • Schemas
    • Client
    • Product
    • ClientNotificationsRequest
    • ClientNotificationsResponse
    • ErrorDetail
    • ErrorResponse
    • ValidationErrorResponse
  1. Transaction

Transaction History

GET
/core/transactions/{nuban}

Get Account Transactions#

Retrieves the transaction history for a single account within a date range.

Request#

Path Parameters#

ParameterTypeRequiredDescription
nubanstringYes10-digit NUBAN of the account whose transactions are requested.

Query Parameters#

ParameterTypeRequiredFormatDescription
startDatestringYesDD-MM-YYYYStart of the date range (inclusive).
endDatestringYesDD-MM-YYYYEnd of the date range (inclusive).

Example Request#

Response#

Success: 200 OK#

Returns a JSON array of transaction objects, ordered by createdDate descending (most recent first).

Transaction Object#

FieldTypeAlways presentDescription
idintegerYesUnique transaction identifier.
nubanstringYesAccount number the transaction belongs to.
amountnumberYesTransaction amount.
notestringYesNarration or description of the transaction.
transactionTypestringYesWithdrawal or Deposit.
balancenumberYesAccount balance immediately after the transaction.
createdDatestringYesCreation timestamp, ISO 8601 (UTC).
currencystringYesISO 4217 currency code, e.g. NGN.
clientNamestringYesAccount holder's name.
sessionIDstringNoInterbank session ID. Present only on records confirmed by the gateway.
transactionReferencestringNoTransaction reference. Present only on records confirmed by the gateway.
transferDetailsobjectNoPresent only for transfer transactions. See below.

transferDetails Object#

FieldTypeNullableDescription
typestringNoTransfer type, e.g. OUTWARD_TRANSFER.
amountnumberNoTransfer amount.
transactionStatusstringNoTransfer status. Observed values: AUTHORIZED, SENT_TO_GATEWAY_SUCCESS.
narrationstringNoTransfer narration.
sourceInstitutionCodestringNoInstitution code of the source bank.
sourceBankNamestringNoSource bank name (may be empty).
sourceAccountNUBANstringNoSource account number.
sourceAccountNamestringNoSource account name.
destinationInstitutionCodestringNoInstitution code of the destination bank.
destinationBankNamestringNoDestination bank name.
destinationAccountNamestringNoDestination account name.
destinationAccountNUBANstringNoDestination account number.
transactionReferencestringYesNull until the transfer is sent to the gateway.
sessionIdstringYesNull until the transfer is sent to the gateway.
tpGatewayTransactionReferencestringNoTransaction Point gateway reference; shared by all records for the same transfer.
paymentReferencestringYesOptional payment reference.

Error Responses#

To be confirmed (e.g. invalid NUBAN, malformed date, startDate after endDate, unauthorized).

Notes#

1.
Transaction types. Fees and charges (e.g. SMS CHARGES, ACCOUNT MAINTENANCE FEE, ACCOUNT ACTIVATION FEE) are returned as Withdrawal records. Their note field follows the pattern <name> - <nuban> - <reference> <DESCRIPTION>.
2.
Transfers produce multiple records. A single outward transfer appears as more than one record sharing the same tpGatewayTransactionReference:
An AUTHORIZED record for the transfer amount (e.g. 12020), with null transactionReference and sessionId.
A later SENT_TO_GATEWAY_SUCCESS record carrying the gateway references. In the sample, its amount (26.88) differs from the transfer amount and the balance reduces by that figure, which suggests a fee or charge entry. Please confirm.
3.
Running balance. balance is the post-transaction balance, so a record's balance equals the next-older record's balance minus its own amount (for withdrawals).
4.
Optional fields. sessionID, transactionReference and transferDetails are omitted entirely on non-transfer records; clients should not assume they exist.
5.
Pagination. None is evident; the full range is returned in one response. Large ranges may produce large payloads. To be confirmed.

Request

Authorization
OAuth 2.0
Client Credentials
Add the parameter
Authorization
to Headers，whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Token URL: {{tpGatewayHostUrl}}/security/authenticate
or
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/transactions/0000000024?startDate=1-03-2022&endDate=13-08-2023'

Responses

🟢200Success
application/json
Success
Bodyapplication/json

Example
[
  {
    "id": 3545,
    "nuban": "0000000083",
    "amount": 26.88,
    "note": "Test Transfer 12020",
    "transactionType": "Withdrawal",
    "balance": 37593.12,
    "createdDate": "2026-09-25T04:46:16Z",
    "currency": "NGN",
    "sessionID": "999992260925044614198626360551",
    "transactionReference": "999992260925044614198626360551",
    "clientName": "Sample Customer 8",
    "transferDetails": {
      "type": "OUTWARD_TRANSFER",
      "amount": 26.88,
      "transactionStatus": "SENT_TO_GATEWAY_SUCCESS",
      "narration": "Test Transfer 12020",
      "sourceInstitutionCode": "999992",
      "sourceBankName": "",
      "sourceAccountNUBAN": "0000000083",
      "sourceAccountName": "Sample Customer 8",
      "destinationInstitutionCode": "000001",
      "destinationBankName": "Sterling Bank",
      "destinationAccountName": "Sample Customer",
      "destinationAccountNUBAN": "0000000771",
      "transactionReference": "999992260925044614198626360551",
      "sessionId": "999992260925044614198626360551",
      "tpGatewayTransactionReference": "NG-990043t4892113020",
      "paymentReference": null
    }
  },
  {
    "id": 2139,
    "nuban": "0000000083",
    "amount": 18,
    "note": "Sample Customer 8 - 0000000083 - DSBP-H309-D143915 SMS CHARGES",
    "transactionType": "Withdrawal",
    "balance": 49640,
    "createdDate": "2026-04-20T01:49:25Z",
    "currency": "NGN",
    "clientName": "Sample Customer 8"
  },
  {
    "id": 424,
    "nuban": "0000000083",
    "amount": 10000,
    "note": "DEPOSIT - Sample Customer 4",
    "transactionType": "Deposit",
    "balance": 59170,
    "createdDate": "2026-02-02T12:40:17Z",
    "currency": "NGN",
    "clientName": "Sample Customer 8"
  }
]
🟠400| Source | Error | When |
🟠401| Source | Error | When |
Modified at 2026-11-02 05:49:11
Previous
Credit Account
Next
Transaction Details [Legacy]
Built with