Skip to content
Last updated

Bank Account Details

Bank account detail endpoints are provided to create, view, and manage bank account details for an account balance.

Via the Multi-Currency Accounts and Balance Accounts sections of this guide, you will know the profile and multi-currency account, as well as the specific balance accounts created. The next optional steps are:

  1. Retrieve bank account details - View existing bank account details for the profile.
  2. Create a bank account details order - Request bank account details for a balance currency.
  3. List bank account detail orders - Check the status of open orders.

Retrieve bank account details

This endpoint returns all AVAILABLE and ACTIVE account details for a profile, including receive options with local and international details. Example bank account details (with id: null) are returned for currencies where details have not been requested.

curl -i -X GET \
  https://api.wise.com/v1/profiles/12345678/account-details \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

For request/response details, see the API reference.

Create a bank account details order

Creates an order to issue bank account details. The order uses the same currency as a previously created balance. Fulfilling all requirements will complete the order (status = DONE).

Requirement statuses:

  • PENDING_USER — Requires action from the user
  • PENDING_TW — Requires action from Wise
  • DONE — Completed

Common requirement types:

  • VERIFICATION — User must be fully verified
  • TOP_UP — A fee must be paid via wise.com
curl -i -X POST \
  https://api.wise.com/v1/profiles/12345678/account-details-orders \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "currency": "EUR"
  }'

For request/response details, see the API reference.

List bank account detail orders

Returns the bank account assignment requests for a profile and multi-currency account.

curl -i -X GET \
  'https://api.wise.com/v3/profiles/12345678/account-details-orders?currency=GBP' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

For request/response details, see the API reference.