---
title: "List Bank Accounts for a User"
method: GET
path: "/v2.01/{ClientId}/users/{UserId}/bankaccounts"
tags: ["bankAccounts"]
---

# List Bank Accounts for a User

`GET /v2.01/{ClientId}/users/{UserId}/bankaccounts`

<Warning icon="fa-regular fa-triangle-exclamation">
**Caution - Payouts refused to Bank Accounts created after April 30, 2026**

Bank Account objects created after April 30, 2026, will not be usable for payouts. External accounts must be registered using the [Recipient endpoints](/api-reference/recipients/recipient-object) and authenticated using SCA.

Payouts to Bank Accounts created after May 1, 2026, will fail with the `ResultCode` [121018](/errors/codes/121018). To resolve this, register the external account using [POST Create a Recipient](/api-reference/recipients/create-recipient) and retry the payout.
</Warning>

<Note icon="fa-regular fa-circle-info">
**Note – Replaced by Recipients feature**

The Bank Account object and endpoints have been replaced by the Recipients feature, which all platforms should integrate instead.

Legacy active Bank Accounts (`Active` is `true`) have been migrated to the new feature and their data is retrievable via the [GET View a Recipient](/api-reference/recipients/view-recipient) endpoint using the same `BankAccountId`. Read more about [legacy bank account migration](/guides/payouts#migration-of-legacy-bank-accounts).
</Note>

<Note icon="fa-regular fa-circle-info"> 
**Note** 

The returned parameters may vary depending on the encountered bank account types.  
</Note>

List Bank Accounts for a User

## Path parameters

- `ClientId` string, required
- `UserId` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `Sort` string
- `Active` boolean, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- ListBankAccountsForAUserResponse
  - `Array (Bank Accounts)` ListBankAccountsForAUserResponseArrayBankAccountsItems[] — The list of Bank Accounts objects created by the platform. Returned parameters can vary depending on the bank account `Type`.
    - `Object (Bank Accounts)` ListBankAccountsForAUserResponseArrayBankAccountsItemsObjectBankAccounts — The Bank Account object created by the platform.
      - `OwnerAddress` Address — The postal address.
        - `AddressLine1` string — The first line of the address.
        - `AddressLine2` string — The second line of the address.
        - `City` string — The city of the address.
        - `Region` string — Required if `Country` is US, CA, or MX. The region of the address.
        - `PostalCode` string — The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
        - `Country` string — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address.
      - `OwnerName` string — The owner of the banking alias, which is set automatically by Mangopay since September 15, 2025 ([read more](/guides/vop/payins#banking-alias-categorization)). If the User owning the attached wallet has `UserCategory` of `OWNER` and the `KYCLevel` of `REGULAR`, then the `OwnerName` is set to the `FirstName` and `LastName` values for a [Natural User](/api-reference/users/natural-user-object-sca) or the `Name` value for a [Legal User](/api-reference/users/legal-user-object-sca). In this case, the `VirtualAccountPurpose` in the API response is `USER_OWNED`. If the User is not KYC verified and an `OWNER`, then the `OwnerName` is set to “MGP `PlatformTradingName`" in standard cases, or else “Mangopay” for Marketplace Payment Extension (MPE) workflows. In this case, the `VirtualAccountPurpose` in the API response is `COLLECTION`. **Caution:** Your platform must ensure that you use the `OwnerName` returned in the API response.
      - `Tag` string — Custom data that you can add to this object.
      - `IBAN` string — The IBAN (international bank account number) for the bank account.
      - `AccountNumber` string — The unique set of digits of the bank account.
      - `BIC` string — The BIC (international identifier of the bank) for IBAN or OTHER-type bank accounts. The BIC can have one of the two following formats: - BIC8 – 8-character BIC (AAAABBCC) - BIC11 – 11-character BIC (AAAABBCCDDD) In which: - AAAA represents the bank code: 4 characters defining the bank - BB represents the country code: 2 characters forming the country ISO code (ISO 3166 format) - CC represents the location code: 2 localization characters (alphabetical or numeric) to distinguish banks from the same country - DDD represents the branch code: 3 characters used to define the branch of the bank (sometimes replaced with XXX)
      - `ABA` string — The American Banking Association (ABA) routing number for US-type bank accounts.
      - `DepositAccountType` string — **Returned values:** `CHECKING`, `SAVINGS` The deposit type for US-type bank accounts.
      - `InstitutionNumber` string — The 3-digit number assigned to Canadian financial institutions, for CA-type bank accounts.
      - `BranchCode` string — The 5-digit number assigned to branches of Canadian financial institutions, for CA-type bank accounts.
      - `BankName` string — The name of the Canadian bank for CA-type bank accounts.
      - `SortCode` string — The 6-digit sort code, assigned to UK financial institutions, for GB-type bank accounts.
      - `Country` string — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country in which the bank account is registered.
      - `UserId` string — The unique identifier of the User (natural or legal) who owns the bank account.
      - `Type` string — **Returned values:** `IBAN`, `US`, `CA`, `GB`, `OTHER` The type of the bank account, indicating the country where the real-life account is registered The values are: - `IBAN` – For accounts registered in countries that use IBAN - `US` – For accounts registered in the United States - `CA` – For accounts registered in Canada - `GB` – For accounts registered in the United Kingdom - `OTHER` – For accounts registered in countries that do not use IBAN (and are not US, CA, GB)
      - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
      - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
      - `Active` boolean — Whether or not the Bank Account is active. Mangopay automatically sets this parameter to `false` if the bank account is closed or does not exist anymore.

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)