> For the complete documentation index, see [llms.txt](https://startbutton.gitbook.io/startbutton-product-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://startbutton.gitbook.io/startbutton-product-api/payouts/bank-list.md).

# Bank List

The bank list endpoint helps merchants retrieve the list of banks for countries or mobile money telcos supported for transfer across all currencies.

### Authentication

| Header        | Value              |
| ------------- | ------------------ |
| Authorization | Bearer SECRET\_KEY |
| Content-Type  | `application/json` |

The secret key can be gotten from the 'Settings' page on your Startbutton dashboard.

See [Authentication](/startbutton-product-api/getting-started/authentication.md).

**Endpoint**

GET `{{baseurl}}/bank/list/:currency?type=:type&countryCode=:countryCode`

Here are sample requests below.

| Param       | Param Type | Required           | Description                                                                                                                                                                                                                                                                                                                                              |
| ----------- | ---------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| currency    | URL        | Yes                | Allowed values: [Available Currencies](/startbutton-product-api/reference/available-currencies.md#for-payouts)                                                                                                                                                                                                                                           |
| type        | Query      | No                 | Allowed values `bank` and `mobile_money` defaults to `bank`                                                                                                                                                                                                                                                                                              |
| countryCode | Query      | Yes (Only for XOF) | <p>Used to get the banklist for other XOF countries aside from Côte d'Ivoire (which is the default)<br><br>Allowed values: <code>BJ</code> for Benin, <code>CI</code> for Cote d’Ivoire,<br><code>TG</code> for Togo,<br><code>SN</code> for Senegal, <code>ML</code> for Mali,<br><code>BF</code> for Burkina Faso,<br><code>CM</code> for Cameroon</p> |

To see supported payment channel for these currencies check [Available Currencies](/startbutton-product-api/reference/available-currencies.md).

Here is a sample response:

```json
{
    "success": true,
    "message": "Bank list retrieved",
    "data": [
        {
            "name": "9mobile 9Payment Service Bank",
            "code": "120001",
            "id": 302
        },
        {
            "name": "Abbey Mortgage Bank",
            "code": "404",
            "id": 174
        },
       ...
   ]
}
```