# 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](authentication) section on how to obtain `<X-App-Wallet-Access-Token>`.

## Bank List

<mark style="color:blue;">`GET`</mark> `https://api.console.staging-api.eyowo.com/v1/queries/banks`

Returns the an array of banks

#### Headers

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

{% tabs %}
{% tab title="200 " %}
```
{
    "success": true,
    "data": {
        "banks": [
            {
                "bankCode": "110005",
                "bankName": "3line Card management Limited"
            },
            {
                "bankCode": "090270",
                "bankName": "AB Microfinance bank"
            },
            {
                "bankCode": "070010",
                "bankName": "ABBEY MORTGAGE BANK"
            },
            ......
        ]
    }
}
```
{% endtab %}
{% endtabs %}

## Verify Bank Details

<mark style="color:blue;">`GET`</mark> `https://api.console.staging-api.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` |

{% tabs %}
{% tab title="200 " %}
```
{
    "success": true,
    "data": {
        "banks": [
            {
                "bankCode": "110005",
                "bankName": "3line Card management Limited"
            },
            {
                "bankCode": "090270",
                "bankName": "AB Microfinance bank"
            },
            {
                "bankCode": "070010",
                "bankName": "ABBEY MORTGAGE BANK"
            },
            ......
        ]
    }
}
```
{% endtab %}
{% endtabs %}

