Name Enquiry

Name Enquiry is used to get details of account number supplied.


To get all details of an account, you make a post request by passing AccountNumber, ,BankCode, and Token in your request body to the name enquire endpoint.

For this request, it is important to note that the payload in the request body are all required for a successful request.

Request Payload

NameData TypeDescription
AccountNumberStringCustomer's account number
BankCodeStringCommercial bank sortcode that can be gotten from BillsPayment GetComemrcialBank endpoint response
TokenStringAuthentication key for this request

Expected Response

If the request is successful, it returns a status code of 200 with a response body.

 "BVN": "22233344455",
 "KYC": "3",
 "IsSuccessful": true,
 "SessionID": "",
 "ResponseMessage": "Successful",
 "DefaultGateWay": "ISW",
 "InstitutionCode": null

You can check out API reference for Name Enquiry