Bank Accounts Advance

This endpoint allows you to verify a bank account number.

Suggest Edits

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

KeyDescription
app-idYour App ID
x-api-keyYour Secret Key

Request Body

KeyDescription
numberAccount number
bank_codeCode 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

ResponseDescription
statusIndicates that the request was successful.
detailThis field indicates the detail of the response.
response_codeRepresents the response code.
account_dataAn object containing the following fields:
account_nameThe name of the account.
identity_numberThe identity number of the account holder.
identity_typeThe type of identity number. Can either be NIN or BVN.
dobThe date of birth of the account holder.
genderThe gender of the account holder.
other_namesAny other names of the account holder.
first_nameThe first name of the account holder.
last_nameThe last name of the account holder.
phoneThe phone number of the account holder.
emailThe email address of the account holder.
address_1The first line of the address of the account holder.
lga_of_originThe local government area of origin of the account holder.
lga_of_residenceThe local government area of residence of the account holder.
marital_statusThe marital status of the account holder.
nationalityThe nationality of the account holder.
country_of_birthThe country of birth of the account holder.
country_of_issueThe country of issue of the identity number.
state_of_originThe state of origin of the account holder.
state_of_residenceThe state of residence of the account holder.
account_currencyThe currency of the account.
account_typeThe type of account.
verificationIt holds additional details about the verification process.
statusIndicates the status of the verification.
referenceIt is a string representing a unique reference or identifier associated with the verification process.

Updated 2 months ago