Given a specific validation request as detailed in table below, confirm that the individual with the account number and BVN specified exists. The system returns a YES in the data section of the response if the individual exists and is linked to the provided BVN. Otherwise, a NO is returned in the data section of the response.
Base URL: https://api-gateway.interswitchng.com/isw-data-service
Request Body Fields
SN | Field Name | Data Type | Max Length / Format | Required | Description |
2 | firstname | String | Yes | The firstName of the individual to be vetted against the BVN and bank account details | |
3 | lastname | String | Yes | The lastName of the individual to be vetted against the BVN and bank account details | |
4 | birthDate | Date | yyyy-MM-dd | Yes | The date of birth of the individual to be vetted against the BVN and bank account details |
5 | gender | String | Yes | The gender of the individual to be vetted against the BVN and bank account details | |
6 | phone | String | Yes | The phone number of the individual to be vetted against the BVN and bank account details | |
7 | bvn | String | 11 | Yes | The BVN of the individual to be vetted |
8 | accountNumber | String | Yes | The account number of the individual whose details is to be vetted against the provided details | |
9 | bankCode | String | Yes | The CBN approved unique bankCcode for the bank the account is in | |
10 | country | String | Yes | The unique shortCode for the country the individuals bank is in |
Request URL: {{baseurl}}/api/v1/request/verification/bvn/account
Request Headers
HTTP Method: POST
Content-Type: application/json
Authorization: Bearer Token
Sample Request
{
"firstname": "john",
"lastname": "doe",
"birthDate": "1990-01-01",
"gender": "male",
"phone": "08030000000",
"bvn": "11111111111",
"accountNumber": "0696363603",
"bankCode": "044",
"country": "NGA"
}
Sample Response
{
"responseCode": "00",
"responseMessage": Successful,
"data":
{
"type": "BVN and Bank Account verification",
"isVerified": "NO"
}
}