v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

bank-account-details

Retrieve bank account details

Returns a list with all the AVAILABLE and ACTIVE account details for the given profile, including examples. Account receive options can also include local and international details to receive money on the currency balance.

Example bank account details are returned for any currency where bank account details have not been requested and issued. Examples will always include an id of null.

get/v1/profiles/{profileId}/account-details

Path parameters

profileIdinteger required

Example:12345678

The ID of the profile to retrieve bank account details for.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Response

A list of bank account details.

idinteger nullable

Bank account details ID. Returns null for preview account details that have not yet been issued.

titlestring

Account title.

subtitlestring

Account subtitle.

status'AVAILABLE' | 'ACTIVE'

Account details status:

AVAILABLE: Account details do not exist for the user but may be created
ACTIVE: Account details are ready to be used by this user

deprecatedboolean

When true, Wise has issued new account details for the same currency. Users should not use the deprecated account but may still have external references to it.

Example response

[
  {
    "id": 14000001,
    "currency": {
      "code": "EUR",
      "name": "Euro"
    },
    "title": "Your EUR account details",
    "subtitle": "IBAN, SWIFT/BIC",
    "status": "ACTIVE",
    "receiveOptions": [
      {
        "type": "LOCAL",
        "title": "Local",
        "description": {
          "title": "Your EUR account details",
          "body": "Receive from a bank in the Eurozone",
          "cta": {
            "label": "IBAN",
            "content": "BE12 3456 7890 1234"
          }
        },
        "details": [
          {
            "type": "IBAN",
            "title": "IBAN",
            "body": "BE12 3456 7890 1234",
            "description": {
              "title": "What is an IBAN?",
              "body": "<p>IBAN stands for International Bank Account Number.</p>",
              "cta": {
                "label": "IBAN",
                "content": "BE12 3456 7890 1234"
              }
            }
          }
        ]
      }
    ],
    "bankFeatures": [
      {
        "key": "LOCAL_RECEIVE",
        "title": "Receive locally",
        "supported": true
      }
    ]
  }
]