Skip to content
Last updated

Bank account details

Account details allow the account holder, or their customers, to receive funds like a local in that currency's country, without needing a physical bank account there. Account details are optional and not created by default when you open a balance.

Wise provides bank account detail endpoints to create, view, and manage bank account details for an account balance.

Once you create a Multi-currency account and balance accounts, you can then request and list local account details for currencies that support them.

The bank account details endpoint allow you to:

  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>' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479'

For request/response details, see the API reference.

Create a bank account details order

This endpoint 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' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -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>' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479'

For request/response details, see the API reference.