Name Inquiry By Account<\/h2>\n\n\n\n

Endpoint<\/strong><\/p>\n\n\n\n

GET        \/api\/v1\/inquiry\/bank-code\/{SORT_CODE}\/account\/{ACCOUNT_NUMBER}<\/td><\/tr><\/tbody><\/table>\n\n\n\n Request<\/strong><\/p>\n\n\n\n Request Path Variable Description<\/p>\n\n\n\n #<\/th> Path Variable Name<\/th> Data Type<\/th> Required<\/th> Description<\/th><\/tr><\/thead> 1<\/td> SORT_CODE<\/td> Integer<\/td> True<\/td> This must be a valid bank\u2019s CBN code.<\/td><\/tr>  2<\/td> ACCOUNT_NUMBER<\/td> Integer<\/td> True<\/td> This must be a valid account number of any Nigerian bank.<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Request<\/p>\n\n\n\n \/api\/v1\/inquiry\/bank\/058\/account\/0987654321<\/td><\/tr><\/tbody><\/table>\n\n\n\n Header<\/p>\n\n\n\n Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJhdWQiOlsiY2FyZGxlc3Mtc2VydmljZSIsImNyZWRpdC1zY29yZS1zZXJ2aWNlIiwiaW5jb2duaXRvIiwiaXN3LWNvbGxlY3Rpb25zIiwiaXN3LWNvcmUiLCJpc3ctbGVuZGluZy1zZXJ2aWNlIiwiaXN3LXBheW1lbnRnYXRld2F5IiwicGFzc3BvcnQiLCJwYXltZW50LXNlcnZpY2UiLCJwcm9qZWN0LXgtbWVyY2hhbnQiLCJwd20iLCJ2YXVsdCJdLCJtZXJjaGFudF9jb2RlIjoiTVgxODciLCJwcm9kdWN0aW9uX3BheW1lbnRfY29kZSI6IjAwMTY0NjM5ODU0IiwicmVxdWVzdG9yX2lkIjoiMDAxMTc2MTQ5OTIiLCJzY29wZSI6WyJwcm9maWxlIl0sImp0aSI6IjY5NWZlYWQyLWMwZjgtNDNlMS04YzgxLTUzM2Y2NjUyYWI2YSIsInBheWFibGVfaWQiOiIyMzI0IiwiY2xpZW50X2lkIjoiSUtJQTk2MTRCODIwNjRENjMyRTlCNjQxOERGMzU4QTZBNEFFQTg0RDcyMTgiLCJwYXltZW50X2NvZGUiOiIwNDI1OTQxMzAyNDYifQ<\/th><\/tr><\/tbody><\/table>\n\n\n\n Response<\/strong><\/p>\n\n\n\n Response Body Description(Success)<\/p>\n\n\n\n #<\/th> Field Name<\/th> Data Type<\/th> Description<\/th><\/tr><\/thead> 1<\/td> responseCode<\/td> String<\/td> The Code representing the status of the processing of the request. It shows whether account inquiry was successful or not.<\/td><\/tr> 2<\/td> responseMessage<\/td> String<\/td> The Description of the Response Code from above.<\/td><\/tr> 3<\/td> bvn<\/td> String<\/td> The account holder\u2019s Bank Verification Number(BVN)<\/td><\/tr> 4<\/td> accountNumber<\/td> String<\/td> The account holder\u2019s account number.<\/td><\/tr> 5<\/td> accountName<\/td> String<\/td> The account holder\u2019s account name.<\/td><\/tr> 6<\/td> bankCode<\/td> String<\/td> The bank\u2019s CBN code.<\/td><\/tr> 7<\/td> firstName<\/td> String<\/td> The account holder\u2019s first name<\/td><\/tr> 8<\/td> lastName<\/td> String<\/td> The account holder\u2019s last name<\/td><\/tr> 9<\/td> dob<\/td> String<\/td> The account holder\u2019s date of birth (Format: dd-MMM-yy)<\/td><\/tr> 10<\/td> phone<\/td> String<\/td> The account holder\u2019s mobile phone number<\/td><\/tr> 11<\/td> residentialAddress<\/td> String<\/td> The account holder\u2019s residential address<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (Success)<\/p>\n\n\n\n {     “responseCode”: “00”,     “responseMessage”: “Successful”,     “bvn”: “12345678901”,     “accountNumber”: “0987654321”,     “accountName”: “JOHN JUNIOR DOE”,     “bankCode”: “058”, “firstName”: “JOHN”, “lastName”: “DOE”, “dob”: “\u201c01-Jan-70”, “phone”: “08012345678”, “residentialAddress”: “8 MARS FLAT,JOHNSON CRES. IKORODU ROAD LAGOS STATE” }<\/td><\/tr><\/tbody><\/table>\n\n\n\n Response Body Description(Failure)<\/p>\n\n\n\n #<\/th> Field Name<\/th> Data Type<\/th> Description<\/th><\/tr><\/thead> 1<\/td> responseCode<\/td> String<\/td> The Code representing the status of the processing of the request. It shows whether account inquiry was successful or not.<\/td><\/tr> 2<\/td> responseMessage<\/td> String<\/td> The Description of the Response Code from above.<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response(Failure)<\/p>\n\n\n\n {     “responseCode”: “10400”,     “responseMessage”: “Invalid CBN Bank Code supplied” }<\/td><\/tr><\/tbody><\/table>\n\n\n\n Name Inquiry By BVN<\/h2>\n\n\n\n Endpoint<\/strong><\/p>\n\n\n\n GET       \/api\/v1\/inquiry\/bvn\/{BVN}<\/td><\/tr><\/tbody><\/table>\n\n\n\n Request<\/strong><\/p>\n\n\n\n Request Path Variable Description<\/p>\n\n\n\n #<\/th> Path Variable Name<\/th> Data Type<\/th> Required<\/th> Description<\/th><\/tr><\/thead> 1<\/td> BVN<\/td> Integer<\/td> True<\/td> The account hollder’s Bank Verification Number(BVN)<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Request<\/p>\n\n\n\n \/api\/v1\/inquiry\/bvn\/12345678901<\/td><\/tr><\/tbody><\/table>\n\n\n\n Header<\/p>\n\n\n\n Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJhdWQiOlsiY2FyZGxlc3Mtc2VydmljZSIsImNyZWRpdC1zY29yZS1zZXJ2aWNlIiwiaW5jb2duaXRvIiwiaXN3LWNvbGxlY3Rpb25zIiwiaXN3LWNvcmUiLCJpc3ctbGVuZGluZy1zZXJ2aWNlIiwiaXN3LXBheW1lbnRnYXRld2F5IiwicGFzc3BvcnQiLCJwYXltZW50LXNlcnZpY2UiLCJwcm9qZWN0LXgtbWVyY2hhbnQiLCJwd20iLCJ2YXVsdCJdLCJtZXJjaGFudF9jb2RlIjoiTVgxODciLCJwcm9kdWN0aW9uX3BheW1lbnRfY29kZSI6IjAwMTY0NjM5ODU0IiwicmVxdWVzdG9yX2lkIjoiMDAxMTc2MTQ5OTIiLCJzY29wZSI6WyJwcm9maWxlIl0sImp0aSI6IjY5NWZlYWQyLWMwZjgtNDNlMS04YzgxLTUzM2Y2NjUyYWI2YSIsInBheWFibGVfaWQiOiIyMzI0IiwiY2xpZW50X2lkIjoiSUtJQTk2MTRCODIwNjRENjMyRTlCNjQxOERGMzU4QTZBNEFFQTg0RDcyMTgiLCJwYXltZW50X2NvZGUiOiIwNDI1OTQxMzAyNDYifQ<\/th><\/tr><\/tbody><\/table>\n\n\n\n Response<\/strong><\/p>\n\n\n\n Response Body Description(Success)<\/p>\n\n\n\n #<\/th> Field Name<\/th> Data Type<\/th> Description<\/th><\/tr> #<\/th> Field Name<\/th> Data Type<\/th> Description<\/th><\/tr><\/thead> 1<\/td> responseCode<\/td> String<\/td> The Code representing the status of the processing of the request. It shows whether account inquiry was successful or not.<\/td><\/tr> 2<\/td> responseMessage<\/td> String<\/td> The Description of the Response Code from above.<\/td><\/tr> 3<\/td> bvn<\/td> String<\/td> The account holder\u2019s Bank Verification Number(BVN)<\/td><\/tr> 4<\/td> firstName<\/td> String<\/td> The account holder\u2019s first name<\/td><\/tr> 5<\/td> lastName<\/td> String<\/td> The account holder\u2019s last name<\/td><\/tr> 6<\/td> dob<\/td> String<\/td> The account holder\u2019s date of birth (Format: dd-MMM-yy)<\/td><\/tr> 7<\/td> phone<\/td> String<\/td> The account holder\u2019s mobile phone number<\/td><\/tr> 8<\/td> residentialAddress<\/td> String<\/td> The account holder\u2019s residential address<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response (Success)<\/p>\n\n\n\n {     “responseCode”: “00”,     “responseMessage”: “Successful”,     “bvn”: “12345678901”, “firstName”: “JOHN”, “lastName”: “DOE”, “dob”: “\u201c01-Jan-70”, “phone”: “08012345678”, “residentialAddress”: “8 MARS FLAT,JOHNSON CRES. IKORODU ROAD LAGOS STATE” }<\/td><\/tr><\/tbody><\/table>\n\n\n\n Response Body Description(Failure)<\/p>\n\n\n\n #<\/th> Field Name<\/th> Data Type<\/th> Description<\/th><\/tr><\/thead> 1<\/td> responseCode<\/td> String<\/td> The Code representing the status of the processing of the request. It shows whether account inquiry was successful or not.<\/td><\/tr> 2<\/td> responseMessage<\/td> String<\/td> The Description of the Response Code from above.<\/td><\/tr><\/tbody><\/table>\n\n\n\n Sample Response(Failure)<\/p>\n\n\n\n {     “responseCode”: “10400”,     “responseMessage”: “Invalid BVN Specified” }<\/td><\/tr><\/tbody><\/table>\n","protected":false},"author":228,"featured_media":0,"parent":2232,"menu_order":10,"comment_status":"open","ping_status":"closed","template":"","meta":{"spay_email":""},"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4393"}],"collection":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/users\/228"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=4393"}],"version-history":[{"count":1,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4393\/revisions"}],"predecessor-version":[{"id":4394,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4393\/revisions\/4394"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/2232"}],"prev":[{"title":"Get Customer Virtual Account","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/ils\/get-customer-virtual-account\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/4090"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=4393"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=4393"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}