Virtual Account Services
  1. Account
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
        GET
      • Activate Sub Ledger For Merchant
        POST
      • Get SubLedger Callback Urls
        GET
      • Set SubLedger Callback Urls
        POST
      • Get Collection Accounts
        GET
    • 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
      • Dashboard Transactions
      • Dashboard Transaction Details
    • 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. Account

Get Account

GET
/merchant/account/getaccount/{nuban}
This API retrieves account details based on the specified NUBAN (Bank Account Number).

Path Parameter#

Field NameTypeRequiredDescription
nubanstringtrueThe NUBAN (Bank Account Number) associated with the account

Response Body#

Field NameTypeDescription
accountTypestringSpecifies the type of account. Possible values: SUBLEDGER, SAVINGS_ACCOUNT.
sessionIDstringA unique identifier for the session, if available.
transactionIdstringThe ID of the transaction, if applicable.
destinationInstitutionCodestringThe financial institution code of the destination account, if applicable.
destinationAccountNUBANstringThe NUBAN (Bank Account Number) of the destination account, if provided.
destinationAccountNamestringThe name associated with the destination account.
destinationAccountBankVerificationNumberstringThe BVN (Bank Verification Number) of the destination account holder, if available.
destinationBankNamestringThe name of the bank where the destination account is held, if provided.
nameInquiryReferencestringA reference identifier used for name inquiry verification, if applicable.

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 '/merchant/account/getaccount/9900000774'

Responses

🟢200SubLedger Type
application/json
Body

Example
{
    "accountType": "SUBLEDGER",
    "sessionID": null,
    "transactionId": null,
    "destinationInstitutionCode": null,
    "destinationAccountNUBAN": null,
    "destinationAccountName": "Mohammed Olateju",
    "destinationAccountBankVerificationNumber": null,
    "destinationBankName": null,
    "nameInquiryReference": null
}
🟢200Savings Account Type
Modified at 2025-03-15 08:34:47
Previous
Send Notification
Next
Activate Sub Ledger For Merchant
Built with