Retrieve bank list

TEST DATA number: 10101010101 mode: BVN

Retrieve all bank account linked to either a phone number or a BVN

POST {{URL}}/api/v2/biometrics/merchant/data/verification/banks/retrieve

This endpoint allows you to verify a bank account number.

Query Parameters

Name	Type	Description
number*	string	phone number or BVN
mode*	string	BVN or PHONE

Headers

Name	Type	Description
x-api-key*	string	<your secret key>
app-id*	String	<your app id>

200 Accounts retrieved successfully

{
    "status": true,
    "detail": "Verification Successful",
    "response_code": "00",
    "data": [
        {
            "bankCode": "032",
            "bankName": "Union Bank",
            "mobile_number": "07012345678",
            "accountDescription": "000****111"
        },
        {
            "bankCode": "044",
            "bankName": "Access Bank Nigeria Plc",
            "mobile_number": "07012345678",
            "accountDescription": "000****111"
        },
        {
            "bankCode": "032",
            "bankName": "Union Bank",
            "mobile_number": "07012345678",
            "accountDescription": "000****111"
        },
        {
            "bankCode": "044",
            "bankName": "Access Bank Nigeria Plc",
            "mobile_number": "07012345678",
            "accountDescription": "000****111"
        },
        {
            "bankCode": "057",
            "bankName": "Zenith Bank",
            "mobile_number": "07012345678",
            "accountDescription": "000****111"
        },
        {
            "bankCode": "035",
            "bankName": "Wema Bank",
            "mobile_number": "07012345678",
            "accountDescription": "000****111"
        },
        {
            "bankCode": "011",
            "bankName": "FBN",
            "mobile_number": "07012345678",
            "accountDescription": "318XXXX885"
        }
    ],
    "verification": {
        "status": "VERIFIED",
        "reference": "350bf819-876f-4f81-94cb-17a5240007d9",
        "endpoint": "Bank Account list"
    }
}