---
title: "View a Bank Account"
method: GET
path: "/v2.01/{ClientId}/users/{UserId}/bankaccounts/{BankAccountId}"
tags: ["bankAccounts"]
---

# View a Bank Account

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

<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>

View a Bank Account

## Path parameters

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

## Headers

- `Authorization` string, required

## Response `200`

Success

- ViewABankAccountResponse
  - `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.
  - `IBAN` string — Max. length: 34 characters The IBAN (international bank account number) of the bank account. It follows the CCDDBBAN format in which: - CC represents the country code (ISO 3166-1 alpha 2) - DD represents two check digits used by banking systems to avoid simple errors - BBAN stands for the Basic Bank Account Number which is up to 30 alphanumeric characters that are country-specific. Note: You will need a valid IBAN (i.e., existing in real life) when testing on a Sandbox account even if no actual payout will be processed.
  - `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)
  - `UserId` string — The unique identifier of the User (natural or legal) who owns the bank account.
  - `OwnerName` string — Max. length: 255 characters The full name of the owner of the bank account. (Format: FirstName LastName)
  - `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.
  - `Tag` string — Max. length: 255 characters Custom data that you can add to this 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.
  - `AccountNumber` string — Length: 8 digits The unique set of digits of the bank account.
  - `SortCode` string — The 6-digit sort code, assigned to UK financial institutions, for GB-type bank accounts.

---

[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/956211a94070/schema)