Skip to content

Get account details by ID

Request

Retrieves account details by ID. Account details identify an account that can receive funds (e.g. an IBAN, or a sort code and account number). GB, US and BE account details are supported. Requesting account details for an unsupported country returns 404 Not Found. For coverage across all countries, use the 2026Q3 account details API.

Security
ClientCredentialsToken or UserToken
Path
idinteger, (int64)required

Unique identifier for the account details.

Example:12345678
Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

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

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
curl -i -X GET \
  https://api.wise.com/2026Q4/balances/account-details/12345678 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479'

Responses

GetAccountDetails 200 response

Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"
Bodyapplication/json
idinteger, (int64)required

Unique identifier for the account details.

Example:12345678
profileIdinteger, (int64)required

Profile ID of the account details owner.

Example:12345678
statestringrequired

Current state of the account details.

Enum:"ACTIVE""INACTIVE"
accountHolderNamestring, <= 140 charactersrequired

Name of the account holder as it appears on the account details.

Example:"Sarah Jenkins"
countrystring, = 2 characters^[A-Z]{2}$required

ISO 3166-1 alpha-2 country code the account details belong to.

Example:"GB"
accountIdentificationbeAccountIdentification (object) or gbAccountIdentification (object) or usAccountIdentification (object)required
One of:

Country/scheme-specific account identification.

Response
{
  "id": 32345678,
  "profileId": 87654321,
  "state": "ACTIVE",
  "accountHolderName": "Sarah Jenkins",
  "country": "BE",
  "accountIdentification": {
    "beAccountIdentification": {
      "bic": "TRWIBEB1",
      "iban": "BE71096123456769",
      "institutionName": "Wise",
      "institutionAddress": { … }
    }
  }
}