Core Banking Services
  1. Account
Core Banking Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Product List
      GET
    • Create Account
      POST
    • 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
  • Transaction
    • Payment Types
      GET
    • Debit Account
      POST
    • Credit Account
      POST
    • Transaction History
      GET
    • Transaction Details
      GET
  • Transfer
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • InterBank Transfer Query
      GET
    • Transfer Details
      GET
    • IntraBank Transfer
      POST
    • Intrabank Transfer To Virtual Accounts
      POST
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  1. Account

Accounts

GET
/core/accounts/{clientId}
This API retrieves a list of savings accounts of a client by clientId. It provides details such as the account holder’s name, account number (NUBAN), balances, product type, and recent transaction activities.

Path Parameter#

Field NameTypeRequiredDescription
clientIdstringTRUEThe unique identifier of the account holder whose accounts are being retrieved.

Response#

Field NameTypeDescription
idintegerUnique identifier for the account
firstnamestringAccount holder's first name
lastnamestringAccount holder's last name
nubanstringUnique account number (NUBAN)
currentBalancefloatTotal balance including pending transactions
availableBalancefloatBalance available for withdrawal
productIdintegerIdentifier for the account product type
subLedgerActivatedbooleanIndicates if the sub-ledger is activated
accountNamestringFull name of the account holder
productNamestringName of the account product
coreBankingAccountIdintegerCore banking system identifier for the account
thisWeekCreditsfloatTotal credits received this week
thisWeekDebitsfloatTotal debits made this week

Request

Path Params
clientId
string 
required
Example:
1

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 '/core/accounts/1'

Responses

🟢200Success
application/json
Body
object {0}
Example
[
    {
        "id": 1,
        "firstname": "CHRISTIAN ONYEMA",
        "lastname": "EBIRIMSON",
        "nuban": "1100000011",
        "currentBalance": 168283.3,
        "availableBalance": 168283.3,
        "productId": 101,
        "subLedgerActivated": false,
        "accountName": "CHRISTIAN ONYEMA EBIRIMSON",
        "productName": "FullRange Savings account",
        "coreBankingAccountId": 1,
        "thisWeekCredits": 798097.5,
        "thisWeekDebits": 630529.01
    },
    {
        "id": 16388,
        "firstname": "CHRISTIAN ONYEMA",
        "lastname": "EBIRIMSON",
        "nuban": "0000000147",
        "currentBalance": 100000,
        "availableBalance": 100000,
        "productId": 136,
        "subLedgerActivated": false,
        "accountName": "CHRISTIAN ONYEMA EBIRIMSON",
        "productName": "savingtest",
        "coreBankingAccountId": 16388,
        "thisWeekCredits": 100000,
        "thisWeekDebits": 0
    }
]
Modified at 2025-03-19 15:01:43
Previous
Find Client
Next
Create Additional Account
Built with