Deprecated APIs
Deprecated APIs are those that are no longer the standard version and have been marked as such. They will continue to work for the foreseeable future, but should not be used for new integrations.
GET /v1/borderless-accounts?profileId={{profileId}}
Get available balances for all activated currencies in your multi-currency account.
Use profile ID obtained earlier to make this call.
Multi-currency account ID
Personal or business profile ID
Recipient ID you can use for a multi-currency account deposit
Date when multi-currency account was opened
Date when multi-currency account setup was modified.
Is multi-currency account active or inactive
Ignore
AVAILABLE
Currency code
Available balance in specified currency
Currency code
Reserved amount from your balance
Reserved amount currency code
Bank account details assigned to your multi-currency account. Available for EUR, GBP, USD, AUD, NZD
Bank account details ID
Bank account currency
Bank account code
Bank account number
Bank account swift code
Bank account iban
Bank name
Bank account holder name
Bank address street and house
Bank address zip code
Bank address city
Bank address country
Bank address state code
curl -X GET https://api.sandbox.transferwise.tech/v1/borderless-accounts?profileId={{profileId}} \-H 'Authorization: Bearer <your api token>'
[{"id": 64,"profileId": 33333333,"recipientId": 13828530,"creationTime": "2018-03-14T12:31:15.678Z","modificationTime": "2018-03-19T15:19:42.111Z","active": true,"eligible": true,"balances": [{"balanceType": "AVAILABLE","currency": "GBP","amount": {"value": 10999859,"currency": "GBP"},"reservedAmount": {"value": 0,"currency": "GBP"},"bankDetails": null},{"balanceType": "AVAILABLE","currency": "EUR","amount": {"value": 9945236.2,"currency": "EUR"},"reservedAmount": {"value": 0,"currency": "EUR"},"bankDetails": {"id": 90,"currency": "EUR","bankCode": "DEKTDE7GXXX","accountNumber": "DE51 7001 1110 6050 1008 91","swift": "DEKTDE7GXXX","iban": "DE51 7001 1110 6050 0008 91","bankName": "Handelsbank","accountHolderName": "Oliver Wilson","bankAddress": {"addressFirstLine": "Elsenheimer Str. 41","postCode": "80687","city": "München","country": "Germany","stateCode": null}}}]}]
POST /v1/borderless-accounts/{{borderlessAccountId}}/conversions
Convert funds between your multi-currency account currencies. Quote which is used in this call must be created with "payOut": "BALANCE".
Note that this call needs an extra field in header called "X-idempotence-uuid".
Conversion quote ID
Unique identifier assigned by you. Used for idempotency check purposes. Should your call fail for technical reasons then you can use the same value again for making retry call.
curl -X POST https://api.sandbox.transferwise.tech/v1/borderless-accounts/{{borderlessAccountId}}/conversions \-H 'Authorization: Bearer <your api token>' \-H 'Content-Type: application/json' \-H 'X-idempotence-uuid: <generated uuid>' \-d '{"quoteId": <conversion quote ID>}'
{"id": 1,"type": "CONVERSION","state": "COMPLETED","balancesAfter": [{"value": 10000594.71,"currency": "GBP"},{"value": 9998887.01,"currency": "EUR"}],"creationTime": "2017-11-21T09:55:49.275Z","steps": [{"id": 369588,"type": "CONVERSION","creationTime": "2017-11-21T09:55:49.276Z","balancesAfter": [{"value": 9998887.01,"currency": "EUR"},{"value": 10000594.71,"currency": "GBP"}],"channelName": null,"channelReferenceId": null,"tracingReferenceCode": null,"sourceAmount": {"value": 113.48,"currency": "EUR"},"targetAmount": {"value": 100,"currency": "GBP"},"fee": {"value": 0.56,"currency": "EUR"},"rate": 0.88558}],"sourceAmount": {"value": 113.48,"currency": "EUR"},"targetAmount": {"value": 100,"currency": "GBP"},"rate": 0.88558,"feeAmounts": [{"value": 0.56,"currency": "EUR"}]}
GET /v1/identity/one-time-token/status
Retrieve necessary information to clear a OTT.
Request
Text value of a OTT.
Response
Properties of OneTimeToken
curl -X GET https://api.sandbox.transferwise.tech/v1/identity/one-time-token/status \-H 'Authorization: Bearer <your api token>'-H 'One-Time-Token: <one time token>'
{"oneTimeTokenProperties": {"oneTimeToken": "9f5f5812-2609-4e48-8418-b64437c0c7cd","challenges": [{"primaryChallenge": {"type": "PIN","viewData": {"attributes": {"userId": 6146956}}},"alternatives": [],"required": true,"passed": false}],"validity": 3600,"actionType": "BALANCE__GET_STATEMENT","userId": 6146956}}
PUT /v3/spend/profiles/{{profileId}}/cards/{{cardToken}}/phone-number
Please note that this endpoint is deprecated for partners onboarded after 1/3/2025. For new and existing partners, your clientId will need to be whitelisted by our support team to make the phoneNumber optional in the create card order endpoint. See 3ds for more information. This endpoint updates the phone number of a card. The new phone number must be a valid phone number.
Must be a valid phone number prefixed with + and country code. An example of a valid phone number would be +6588888888
curl -X PUT 'https://api.sandbox.transferwise.tech/v3/spend/profiles/{{profileId}}/cards/{{cardToken}}/phone-number' \--H 'Authorization: Bearer <your api token>' \--d '{"phoneNumber": "+6588888888}'
Response
The card token that you are modifying
The profile ID that the card is linked to
The new phone number associated with the card
{"token": "12345-12345-12345-12345","profileId": 30000000,"phoneNumber": "+6588888888"}
POST /v3/spend/profiles/{{profileId}}/dispute-form/file
Submit a file for disputes
This API is not available for sandbox testing.
Use the fileId in the response for the dispute submission.
NB: A dispute referencing the returned fileId must be submitted no later than two hours after the file submission, otherwise the file will expire and must be re-submitted.
curl -X POST 'https://api.wise.com/v3/spend/profiles/{{profileId}}/dispute-form/file' \-H 'Authorization: Bearer <your api token>' \-H 'Content-Type: multipart/form-data' \-F 'receipt=@"<your file>"'
Response
ID of the file to be used on dispute submission.
{"receipt" : "ab4f5d2"}