---
title: "List of bank accounts"
description: "Get a list of the existing bank contracts for the specified merchant account."
url: "https://docs.adyen.com/account-management-api/manage-bank-accounts-and-payouts/listbankaccounts"
source_url: "https://docs.adyen.com/account-management-api/manage-bank-accounts-and-payouts/listbankaccounts.md"
canonical: "https://docs.adyen.com/account-management-api/manage-bank-accounts-and-payouts/listbankaccounts"
last_modified: "2026-05-24T12:54:32+02:00"
language: "en"
---
# List of bank accounts
Get a list of the existing bank contracts for the specified merchant account.
[View source](/account-management-api/manage-bank-accounts-and-payouts/listbankaccounts.md)
## Request parameters
To get a list of bank accounts, make a POST `/listBankAccounts` request specifying:
| Name | Type | Required | Description |
| -------------- | ------ | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `accountKey` | String |  | DEPRECATED Not used anymore. Do not use. |
| `merchantCode` | String |  | A merchant code string holds a value to identify a merchant.Format:- Either: `MerchantAccount.Merchant_Code`
- Or: `Merchant_Code` |
## Response parameters
The response contains a list of objects. Each object in the list holds data about one of the queried bank accounts.
| Name | | Type | Returned by default | Description |
| ------------------------------- | ---------------------- | ------ | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `bankAccounts` | | List |  | A container object for bank account data objects.- `bankAccountDataSO` |
| `bankAccountsDeleteUnconfirmed` | | List |  | A container object for bank account data objects. It holds non-confirmed bank account entries marked for deletion.- `bankAccountDataSO` |
| `bankAccountsUpdateUnconfirmed` | | List |  | A container object for bank account data objects. It holds non-confirmed bank account entries marked for update.- `bankAccountDataSO` |
| `bankAccountDataSO` | | Class |  | A container object for bank account data.- `bankCity`
- `bankCode`
- `bankName`
- `bic`
- `branchCode`
- `checkCode`
- `countryCode`
- `currency`
- `foundationAccount`
- `iban`
- `number`
- `owner`
- `ownerCity` |
| | \|-`bankCity` | String |  | The (main) city the bank operates from. `bankCity` is an optional field for EUR transactions.\`\``bankCity` is a *mandatory* field for:- All non-EUR transactions
- All EUR transactions without an IBAN code. |
| | \|-`bankCode` | String |  | The code identifying the bank. The field format is specific to the country/region.`bankCode` is mandatory *only* for the following countries/regions:- Canada
- Hong Kong
- New Zealand
- Singapore
- Taiwan |
| | -`bankName` | String |  | The name of the bank.`bankName` is a *mandatory* field for:- All non-EUR transactions |
| | \|-`bic` | String |  | [Business Identifier Code](https://en.wikipedia.org/wiki/ISO_9362). Unique identifier for the bank. |
| | \|-`branchCode` | String |  | The code identifying the bank branch office. The field format is specific to the country/region.`branchCode` is mandatory *only* for the following countries/regions:- Australia
- Canada
- Great Britain
- Indonesia
- Hong Kong
- New Zealand
- Singapore
- South-Africa
- Taiwan
- United States |
| | \|-`checkCode` | String |  | Code check. It corresponds to checking digits in an IBAN code. If it is included in a transaction, its value is validated against the corresponding IBAN code. `checkCode` should never be included in transactions involving non-IBAN compliant countries/regions. |
| | \|-`countryCode` | String |  | The `country` value format needs to adhere to the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard. An invalid country code results in a transaction/request rejection. You can [look up country codes](https://www.iso.org/obp/ui/) on the ISO website. |
| | \|-`currency` | String |  | The three-character [ISO currency code](https://en.wikipedia.org/wiki/ISO_4217). |
| | \|-`foundationAccount` | String |  | The foundation account number (FAN). A unique identifier. This is a non editable, read-only field. It is relevant only in the call response. |
| | \|-`iban` | String |  | The [International Bank Account Number](https://en.wikipedia.org/wiki/International_Bank_Account_Number). |
| | \|-`number` | String |  | The [bank account](https://en.wikipedia.org/wiki/Bank_account) number. |
| | \|-`owner` | String |  | Name of the bank account owner. |
| | \|-`ownerCity` | String |  | Name of the city where the bank account holder resides. This is a mandatory field when:- The transaction does not include an IBAN.
- The transaction is non-EUR. |
| `pspReference` | | String |  | A reference to uniquely identify the request. |
| `warnings` | | String |  | List containing one or more warning messages. Returned when the request is not correctly processed. |
| `errors` | | String |  | List containing one or more error messages. Returned when the request fails. |
## Examples
### Request
#### JSON
```json
{
"merchantCode":"TestMerchant"
}
```
#### Soap
```xml
TestMerchant
```
### Response
#### JSON
```json
{
"pspReference":"9914526949470174",
"bankAccounts":[
{
"BankAccountDataSO":{
"bic":"TESTNL01",
"countryCode":"NL",
"currency":"EUR",
"foundationAccount":"BankAccount1",
"iban":"NL13TEST0123456789",
"number":"123456789",
"owner":"A. Klaassen"
}
}
]
}
```
#### Soap
```xml
9914140650000269
TESTNL01
NL
EUR
BankAccount1
NL13TEST0123456789
123456789
A. Klaassen
```