> For the complete documentation index, see [llms.txt](https://developer.myidentitypass.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.myidentitypass.com/products/data-verification/nigeria/bank-account-verification-1/account-number-2.0-1.md).

# Retrieve bank list

{% hint style="info" %}
TEST DATA\
\
number: 10101010101\
mode: BVN
{% endhint %}

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

<mark style="color:green;">`POST`</mark> `{{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<mark style="color:red;">\*</mark> | string | phone number or BVN |
| mode<mark style="color:red;">\*</mark>   | string | BVN or PHONE        |

#### Headers

| Name                                        | Type   | Description        |
| ------------------------------------------- | ------ | ------------------ |
| x-api-key<mark style="color:red;">\*</mark> | string | \<your secret key> |
| app-id<mark style="color:red;">\*</mark>    | String | \<your app id>     |

{% tabs %}
{% tab title="200 Accounts retrieved successfully" %}

```json
{
    "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"
    }
}
```

{% endtab %}
{% endtabs %}