List Bank Accounts for a User

GET

/v2.01/:ClientId/users/:UserId/bankaccounts

GET

/v2.01/:ClientId/users/:UserId/bankaccounts

$ curl https://api.sandbox.mangopay.com/v2.01/{ClientId}/users/{UserId}/bankaccounts \
>      -H "Authorization: Bearer <token>"

200Retrieved

1 [
2   {
3     "OwnerAddress": {
4       "AddressLine1": "The Oasis",
5       "AddressLine2": "Rue des plantes",
6       "City": "Paris",
7       "Region": "Ile de Frog",
8       "PostalCode": "75010",
9       "Country": "FR"
10     },
11     "IBAN": "FR7630004000031234567890143",
12     "BIC": "CRLYFRPP",
13     "UserId": "142036728",
14     "OwnerName": "John Doe",
15     "Type": "IBAN",
16     "Id": "142036878",
17     "Tag": "Postman create a bank account",
18     "CreationDate": 1654073079,
19     "Active": true
20   },
21   {
22     "OwnerAddress": {
23       "AddressLine1": "77 Street",
24       "AddressLine2": "Rue des plantes",
25       "City": "Paris",
26       "Region": "Ile de France",
27       "PostalCode": "75009",
28       "Country": "FR"
29     },
30     "AccountNumber": "11696419",
31     "ABA": 71000288,
32     "DepositAccountType": "CHECKING",
33     "UserId": "142036728",
34     "OwnerName": "John Doe",
35     "Type": "US",
36     "Id": "150294885",
37     "Tag": null,
38     "CreationDate": 1661864955,
39     "Active": true
40   }
41 ]

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 and authenticated using SCA.

Payouts to Bank Accounts created after May 1, 2026, will fail with the ResultCode 121018. To resolve this, register the external account using POST Create a Recipient and retry the payout.

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 endpoint using the same BankAccountId. Read more about legacy bank account migration.

Note

The returned parameters may vary depending on the encountered bank account types.

List Bank Accounts for a User

<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

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

If your platform is using a proxy to take SCA-triggering action on behalf of users, you also need to integrate mTLS authentication and use the api-mtls base URL.

Bearer authentication of the form `Bearer <token>`, where token is your auth token. If your platform is using a [proxy](/guides/sca/proxy-management) to take SCA-triggering action on behalf of users, you also need to integrate [mTLS authentication](/guides/sca/platform) and use the `api-mtls` base URL.

Path parameters

ClientIdstringRequired

Platform's API account identifier, associated with the API key.

UserIdstringRequired

The unique identifier of the User (natural or legal) who owns the bank account.

Query parameters

pageintegerOptional

Start value: 1

Default value: 1

Indicates the index of the page for the pagination.

per_pageintegerOptional

Min. value: 1; max. value: 100

Default value: 10

Indicates the number of items returned for each page of the pagination.

SortstringOptional

Possible values: CreationDate:ASC, CreationDate:DESC

Default value: CreationDate:ASC

Indicates the direction in which to sort the list.

ActivebooleanRequired

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.

Response

Success

Array (Bank Accounts)list of objects

The list of Bank Accounts objects created by the platform. Returned parameters can vary depending on the bank account Type.