Account Number 2.0
This endpoint allows you to verify a bank account number.
With the help of this endpoint, you can easily and quickly verify the accuracy of your customers' bank account numbers. This endpoint is like a digital safeguard that ensures that your customers' account information is correct and up-to-date.
Using this endpoint, you can simply input your customer’s account number or bank code and the endpoint will verify the account number in a matter of seconds. In short, this endpoint provides an easy and efficient solution for verifying bank account numbers, saving time and preventing potential errors or fraudulent activities.
TEST DATA
number: 4444444444
bank_code: 214
POST
{{URL}}/identitypass/verification/bank_account/advance
Request Header
| Key | Description |
|---|---|
| app-id | Your App ID |
| x-api-key | Your Secret Key |
Request Body
| Key | Description |
|---|---|
| number | Account number |
| bank_code | Code of user's bank |
Sample Response
{
"status": true,
"detail": "Verification Successful",
"response_code": "00",
"account_data": {
"account_name": "Test Account",
"identity_number": "4444444444",
"identity_type": "NIN",
"dob": "1980-12-22",
"gender": "Male",
"other_names": "",
"first_name": "Test",
"last_name": "Account",
"phone": "07012345678",
"email": "[email protected]",
"address_1": "Lagos",
"lga_of_origin": "Ikeja",
"lga_of_residence": "Ikeja",
"marital_status": "Single",
"nationality": "Nigeria",
"country_of_birth": "Nigeria",
"country_of_issue": "Nigeria",
"state_of_origin": "Edo State",
"state_of_residence": "Lagos State",
"account_currency": "",
"account_type": ""
},
"verification": {
"status": "VERIFIED",
"reference": "2416700e-0174-4abf-b792-7550e4ffecfe"
}
}
Response Description
| Response | Description |
|---|---|
| status | Indicates that the request was successful. |
| detail | This field indicates the detail of the response. |
| response_code | Represents the response code. |
| account_data | An object containing the following fields: |
| account_name | The name of the account. |
| identity_number | The identity number of the account holder. |
| identity_type | The type of identity number. Can either be NIN or BVN. |
| dob | The date of birth of the account holder. |
| gender | The gender of the account holder. |
| other_names | Any other names of the account holder. |
| first_name | The first name of the account holder. |
| last_name | The last name of the account holder. |
| phone | The phone number of the account holder. |
| The email address of the account holder. | |
| address_1 | The first line of the address of the account holder. |
| lga_of_origin | The local government area of origin of the account holder. |
| lga_of_residence | The local government area of residence of the account holder. |
| marital_status | The marital status of the account holder. |
| nationality | The nationality of the account holder. |
| country_of_birth | The country of birth of the account holder. |
| country_of_issue | The country of issue of the identity number. |
| state_of_origin | The state of origin of the account holder. |
| state_of_residence | The state of residence of the account holder. |
| account_currency | The currency of the account. |
| account_type | The type of account. |
| verification | It holds additional details about the verification process. |
| status | Indicates the status of the verification. |
| reference | It is a string representing a unique reference or identifier associated with the verification process. |
Updated over 1 year ago