4. Get account details
GET {{host}}/v1/profiles/{{profile-id}}/account-details
Returns a list with all AVAILABLE
and ACTIVE
account details for the given profile. Account receive options can also include local and international details to receive money on the currency balance.
Important fields for integration
status (text)
AVAILABLE
: The account details are available for the given profile but still does not exist
ACTIVE
: The account details are available and active for the given profile
deprecated (boolean)
!Important
When true
means another account details were issued for the same currency and the deprecated one should not be used anymore. Both will work during the deprecation time, but users should be informed and start using the new account details.
receiveOptions (array)
This array will contain the available receive options for the given currency.
LOCAL
: local bank details to receive money in the account currency
INTERNATIONAL
: SWIFT bank details to receive money internationally in the account currency.
receiveOptions.details (array)
Returns all the details that needs to be displayed to users so they can make transfers to this account. This array will vary from currency to currency as each one has its own requirements.
For example:
EUR will return ACCOUNT_HOLDER
, SWIFT_CODE
, IBAN
and ADDRESS
whereas GBP will return ACCOUNT_HOLDER
, BANK_CODE
, ACCOUNT_NUMBER
, IBAN
and ADDRESS
.
Each element in this array will contain the following attributes:
type
: String informing the account detail type
title
: Title do be displayed to the user
body
: Value to be displayed to the user
description
: If present, it can be used to display a tooltip / popup hint
hidden
: If the field should be displayed or not
Here an example how Wise.com display the GBP receiveOptions.details
for local payments:

HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Authorization | string | Your access token | |
Content-Type | string |
RESPONSES
status: OK
[{"id":1,"currency":{"code":"EUR","name":"Euro"},"title":"Your EUR account details","subtitle":"IBAN, SWIFT/BIC","status":"ACTIVE","deprecated":false,"receiveOptions":[{"type":"LOCAL","title":"Inside EU and SEPA","description":{"title":"Your EUR account details","body":"\u003cp\u003eUse the details below to add or receive EUR from bank accounts inside EU and SEPA.\u003c/p\u003e\u003ca href=\"https://wise.com/help/17/borderless-account/2827505/how-do-i-use-my-eur-bank-details\" rel=\"noopener\" target=\"_blank\"\u003eSee how to use EUR account details\u003c/a\u003e","cta":null},"summaries":[{"type":"TIME","title":"Incoming payments take 1–2 working days to be added to your account","description":null},{"type":"INFO","title":"SEPA includes countries in the EU and EEA","description":{"title":"What’s SEPA?","body":"\n\u003cp\u003eSEPA stands for the Single Euro Payments Area. Within this area, cross-border euro payments must cost the same as a regular, local one. It’s EU law.\u003c/p\u003e\n\u003cp\u003eSEPA covers all the countries within the EU. It also includes other European countries like Monaco, Norway, and Switzerland.\u003c/p\u003e\n\u003cp\u003eSo if your sender is sending from a euro bank account in one of these countries, they shouldn’t have to pay much — if anything — to send money to your EUR account details.\u003c/p\u003e\n\u003ch5\u003eGood to know\u003c/h5\u003e\n\u003cul\u003e\u003cli\u003eSEPA payments to your EUR account details usually take 1–2 working days.\u003c/li\u003e\u003cli\u003eJust because a country uses euros, doesn’t mean it’s in SEPA. Please check the list below if you’re unsure.\u003c/li\u003e\u003c/ul\u003e\n\u003cp\u003e\u003ca href=\"https://wise.com/help/15/paying-for-your-transfer/2968880/sepa-countries-and-ibans\" rel=\"noopener\" target=\"_blank\"\u003eSee the full list of SEPA countries\u003c/a\u003e\u003c/p\u003e","cta":null}}],"details":[{"type":"ACCOUNT_HOLDER","title":"Account holder","body":"John Doe","description":null,"hidden":false},{"type":"SWIFT_CODE","title":"BIC","body":"TRWIBEB1XXX","description":null,"hidden":false},{"type":"IBAN","title":"IBAN","body":"BE58 9671 0000 0000","description":{"title":"Did they ask for an account number?","body":"\n\u003cp\u003eFor most kinds of payments, senders should use your IBAN number. But if they specifically ask for an account number, you can give them this:\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003e1395167\u003c/strong\u003e\u003c/p\u003e","cta":{"label":"IBAN","content":"BE58 9671 0000 0000"}},"hidden":false},{"type":"ADDRESS","title":"Address","body":"Avenue Louise 54, Room S52\nBrussels\n1050\nBelgium","description":{"title":"Did they ask for a bank address?","body":"\n\u003cp\u003eIf your sender asks for a bank address, you can give them:\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eAvenue Louise 54, Room S52\u003cbr\u003eBrussels\u003cbr\u003e1050\u003cbr\u003eBelgium\u003c/strong\u003e\u003c/p\u003e\n\u003ch5\u003eWhat about the bank name?\u003c/h5\u003e\n\u003cp\u003eYou can use TransferWise as the bank name. That’s because in the Eurozone we’re directly plugged into the same payment networks as the big banks. It’s what keeps our payments fast and low-cost.\u003c/p\u003e","cta":{"label":"Address","content":"Avenue Louise 54, Room S52\nBrussels\n1050\nBelgium"}},"hidden":false}],"alert":null,"shareText":""},{"type":"INTERNATIONAL","title":"Outside EU and SEPA","description":{"title":"Your EUR account details","body":"\u003cp\u003eUse the details below to add or receive EUR from bank accounts outside EU and SEPA.\u003c/p\u003e\u003ca href=\"https://wise.com/help/17/borderless-account/2827505/how-do-i-use-my-eur-bank-details\" rel=\"noopener\" target=\"_blank\"\u003eSee how to use EUR account details\u003c/a\u003e","cta":null},"summaries":[{"type":"TIME","title":"Incoming payments take 4–5 working days to be added to your account","description":null}],"details":[{"type":"ACCOUNT_HOLDER","title":"Account holder","body":"John Doe","description":null,"hidden":false},{"type":"SWIFT_CODE","title":"SWIFT/BIC","body":"TRWIBEB1XXX","description":null,"hidden":false},{"type":"IBAN","title":"IBAN","body":"BE58 9671 0000 0000","description":{"title":"Did they ask for an account number?","body":"\n\u003cp\u003eFor most kinds of payments, senders should use your IBAN number. But if they specifically ask for an account number, you can give them this:\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003e1395167\u003c/strong\u003e\u003c/p\u003e","cta":{"label":"IBAN","content":"BE58 9671 0000 0000"}},"hidden":false},{"type":"ADDRESS","title":"Address","body":"Avenue Louise 54, Room S52\nBrussels\n1050\nBelgium","description":{"title":"Did they ask for a bank address?","body":"\n\u003cp\u003eIf your sender asks for a bank address, you can give them:\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eAvenue Louise 54, Room S52\u003cbr\u003eBrussels\u003cbr\u003e1050\u003cbr\u003eBelgium\u003c/strong\u003e\u003c/p\u003e\n\u003ch5\u003eWhat about the bank name?\u003c/h5\u003e\n\u003cp\u003eYou can use TransferWise as the bank name. That’s because in the Eurozone we’re directly plugged into the same payment networks as the big banks. It’s what keeps our payments fast and low-cost.\u003c/p\u003e","cta":{"label":"Address","content":"Avenue Louise 54, Room S52\nBrussels\n1050\nBelgium"}},"hidden":false}],"alert":null,"shareText":""}],"bankFeatures":[{"key":"LOCAL_RECEIVE","title":"Receive locally","supported":true},{"key":"SWIFT","title":"Receive internationally (SWIFT)","supported":true},{"key":"DIRECT_DEBITS","title":"Set up Direct Debits","supported":true},{"key":"PLATFORM_RECEIVE","title":"Receive from PayPal and Stripe","supported":true}]},{"id":null,"currency":{"code":"TRY","name":"Turkish lira"},"title":"Your TRY account details","subtitle":"IBAN","status":"AVAILABLE","deprecated":false,"receiveOptions":[],"bankFeatures":[{"key":"LOCAL_RECEIVE","title":"Receive locally","supported":true},{"key":"SWIFT","title":"Receive internationally (SWIFT)","supported":false},{"key":"DIRECT_DEBITS","title":"Set up Direct Debits","supported":false},{"key":"PLATFORM_RECEIVE","title":"Receive from PayPal and Stripe","supported":false}]}]