v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

balance

Convert currencies between balances (v1)

{% admonition type="warning" %} This endpoint is deprecated. Use the balance movements endpoint to move and convert between balances instead. {% /admonition %}

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.

post/v1/borderless-accounts/{borderlessAccountId}/conversions

Path parameters

borderlessAccountIdinteger required

Your borderless account ID.

Headers

X-idempotence-uuidstring uuid required

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.

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.

Request body

quoteIdinteger required

Conversion quote ID.

Example request

{
  "quoteId": 1234
}

Response

Conversion result.

object required

Conversion result containing source and target amounts, exchange rate, fees, and balance state after conversion.