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

Account Details By BVN

GET
/core/account/bvn/{bvn}
This API retrieves account details associated with a given BVN (Bank Verification Number).

Path Parameter#

Field NameTypeRequiredDescription
bvnstringTRUEThe BVN of the account holder whose accounts are being retrieved.

Response Table#

Field NameTypeDescription
idintegerUnique identifier of the account.
firstnamestringFirst name of the account holder.
lastnamestringLast name of the account holder.
nubanstringGenerated NUBAN (bank account number).
currentBalancefloatCurrent balance in the account.
availableBalancefloatAvailable balance in the account.

Request

Path 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 '/core/account/bvn/8381212'

Responses

🟢200Success
application/json
Body

Example
[
    {
        "id": 20,
        "firstname": "TPGateway",
        "lastname": "User",
        "nuban": "0000000244",
        "currentBalance": 495,
        "availableBalance": 495
    },
    {
        "id": 22,
        "firstname": "TPGateway",
        "lastname": "User",
        "nuban": "0000000268",
        "currentBalance": 0,
        "availableBalance": 0
    }
]
Modified at 2025-03-19 15:01:46
Previous
Create Additional Account
Next
Get Client Addresses
Built with