This API is use to confirm if the supplied BVN and account number belongs to the same entity and retrieve the details of the entity\/account-owner<\/p>\n\n\n\n

Base URL: https:\/\/api-gateway.interswitchng.com\/isw-data-service<\/code><\/em> <\/p><\/blockquote>\n\n\n\n

Request Parameters<\/strong><\/p>\n\n\n\n

SN<\/td>	Field Name<\/td>	Data Type<\/td>	Max Length \/ Format<\/td>	Required<\/td>	Description<\/td><\/tr>
1<\/td>	client-code<\/td>	String<\/td>	20<\/td>	Yes<\/td>	The unique client code provided at the point of profiling the client on the interswitch Data service platform.<\/td><\/tr>
2<\/td>	bvn<\/td>	Integer<\/td>	11<\/td>	YES<\/td>	The 11 digit individually unique BVN number to be validated<\/td><\/tr>
3<\/td>	bank-code<\/td>	integer<\/td>	3<\/td>	Yes<\/td>	The 3 digit unique bank-code assigned by CBN to identify a bank<\/td><\/tr>
4<\/td>	account<\/td>	Integer<\/td>	<\/td>	Yes<\/td>	The bank account number belonging to the bank-code to be validated against the BVN provided<\/td><\/tr><\/tbody><\/table>\n\n\n\n <\/p>\n\n\n\n Sample Request<\/strong><\/p>\n\n\n\n {{baseurl}}\/api\/v1\/request\/verification\/client-code\/sampleClientCode\/bvn\/22355202908\/bank-code\/058\/account\/0261642240<\/code><\/p>\n\n\n\n Request Headers<\/strong><\/p>\n\n\n\n HTTP Method<\/strong>: GET<\/p> Authorization<\/strong>: Bearer TOKEN <\/p><\/blockquote>\n\n\n\n <\/p>\n\n\n\n Sample Response Fields<\/strong> (success)<\/strong><\/p>\n\n\n\n SN<\/td> Field Name<\/td> Data Type<\/td> Description<\/td><\/tr> 1<\/td> responseCode<\/td> String<\/td> The code representing the state of the response, it show whether the response was a success or not. NB: “00” is the code for success<\/td><\/tr> 2<\/td> responseMessage<\/td> String<\/td> The description that explains the responseCode from above <\/td><\/tr> 3<\/td> data<\/td> Object<\/td> The section that contains the account owner details<\/td><\/tr> 4<\/td> bvn<\/td> String<\/td> BVN of the owner of the account, would always be same as the BVN supplied in the request if it was successful<\/td><\/tr> 5<\/td> accountNumber<\/td> String<\/td> Account number of the owner of the account, would always be same as the account number supplied in the request if it was successful<\/td><\/tr> 6<\/td> bankCode<\/td> String<\/td> The bankcode used to identify the bank, would always be same as the bank-code supplied in the request if it was successful<\/td><\/tr> 7<\/td> accountName<\/td> String<\/td> Full names of the account holder<\/td><\/tr> 8<\/td> dob<\/td> String<\/td> The account holder date of birth (Format: dd-MMM-yy)<\/td><\/tr> 9<\/td> firstName<\/td> String<\/td> The account holder\u2019s first name<\/td><\/tr> 10<\/td> lastName<\/td> String<\/td> The account holder\u2019s last name<\/td><\/tr> 9<\/td> phone<\/td> String<\/td> The account holder\u2019s mobile phone number<\/td><\/tr> 10<\/td> residentialAddress<\/td> String<\/td> The account holder\u2019s residential address<\/td><\/tr><\/tbody><\/table>\n\n\n\n <\/p>\n\n\n\n Sample Response<\/strong> (success)<\/strong><\/p>\n\n\n\n {<\/code> \"responseCode\": \"00\",<\/code> \"responseMessage\": \"Successful\",<\/code> \"data\": {<\/code> \"bvn\": \"22292083231\",<\/code> \"accountNumber\": \"0696363603\",<\/code> \"accountName\": \"MICHEAL SYDENY EDE\",<\/code> \"bankCode\": \"044\",<\/code> \"firstName\": \"MICHEAL\",<\/code> \"lastName\": \"EDE\",<\/code> \"dob\": \"12-Mar-75\",<\/code> \"phone\": \"08064088818\",<\/code> \"residentialAddress\": \"SHEHU AUDI RESIDENCE, FUNTUA STREET, KAFANCHAN\"<\/code> }<\/code> }<\/code> <\/p><\/blockquote>\n\n\n\n <\/p>\n\n\n\n Sample Response Fields (Failed)<\/strong><\/p>\n\n\n\n SN<\/td> Field Name<\/td> Data Type<\/td> Description<\/td><\/tr> 1<\/td> responseCode<\/td> String<\/td> The code representing the state of the response, it show whether the response was a success or not. NB: “00” is the code for success<\/td><\/tr> 2<\/td> responseMessage<\/td> String<\/td> The description that explains the responseCode from above <\/td><\/tr><\/tbody><\/table>\n\n\n\n <\/p>\n\n\n\n {<\/code> \"responseCode\": \"10404\",<\/code> \"responseMessage\": \"No Information Found - No Information Found For Account Details\",<\/code> }<\/code> <\/p><\/blockquote>\n","protected":false},"author":169,"featured_media":0,"parent":3611,"menu_order":1,"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\/3614"}],"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\/169"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=3614"}],"version-history":[{"count":4,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3614\/revisions"}],"predecessor-version":[{"id":3737,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3614\/revisions\/3737"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3611"}],"next":[{"title":"Validate Account and BVN","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/interswitch-data-service\/validation-end-points-2\/validate-account-and-bvn\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3617"}],"prev":[{"title":"Retrieve Clear MSISDN","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/interswitch-data-service\/validation-end-points-2\/retrieve-clear-msisdn\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3612"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=3614"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=3614"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}