Banks

For example, you might want to get a list of Nigerian banks and bank code. Retrieving such information should be none trivial. Eyowo provides you with an easy to use endpoint for accessing banks and their respective bank-codes.

To query banks and bank-codes, you must provide an <X-App-Wallet-Access-Token>. Please, see the authentication section on how to obtain <X-App-Wallet-Access-Token>.

Bank List

GET https://api.console.eyowo.com/v1/queries/banks

Returns the an array of banks and bank codes.

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-Token

200

{
    "success": true,
    "data": {
        "banks": [
            {
                "bankCode": "110005",
                "bankName": "3line Card management Limited"
            },
            {
                "bankCode": "090270",
                "bankName": "AB Microfinance bank"
            },
            {
                "bankCode": "070010",
                "bankName": "ABBEY MORTGAGE BANK"
            },
            ......
        ]
    }
}

Verify Bank Details

GET https://api.console.eyowo.com/v1/queries/verify?accountNumber=&bankCode=

Returns { success: true } if the account number is valid.

Query Parameters

Name	Type	Description
bankCode	number	valid bank code
accountNumber	number	11 digits NUBAN number

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-Token

200

{
    "success": true,
    "data": {
        "accountNumber": "2342342122",
        "accountName": "ANYANW  MIDRED"
    }
}