Sign in

v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
quote

Create a quote (unauthenticated)

Use this endpoint to get example quotes for people to see the exchange rate and fees Wise offers before a user has created or linked an account. This can drive a version of the quote screen that shows the user what Wise offers before they sign up. Note that this endpoint does not require a token to create the resource, however, since it is just an example, the returned quote has no ID so can't be used later to create a transfer.

In order to get an accurate partner fee, we require a client credentials token to be provided. If you are a partner and would like your fee to be included in the quote returned, you must provide your auth token. If not, you do not require the Authorization header.

{% admonition type="info" %} Unauthenticated quotes cannot be used to create transfers, they are meant for illustration purposes in partner interfaces only. Make sure to create an authenticated quote during the transfer creation flow. {% /admonition %}

post/v3/quotes

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.

Request body

sourceCurrencystring required

Source (sending) currency code.

targetCurrencystring required

Target (receiving) currency code.

sourceAmountnumber nullable

Amount in source currency. Either sourceAmount or targetAmount is required, never both.

targetAmountnumber nullable

Amount in target currency.

Example request

{
  "sourceCurrency": "GBP",
  "targetCurrency": "USD",
  "targetAmount": 110,
  "pricingConfiguration": {
    "fee": {
      "type": "OVERRIDE",
      "variable": 0.011,
      "fixed": 15.42
    }
  }
}

Response

Returns a quote object.

idstring uuid

ID of this quote (GUID format).

sourceCurrencystring

Source (sending) currency code.

targetCurrencystring

Target (receive) currency code.

sourceAmountnumber

Amount in source currency to send.

targetAmountnumber

Amount in target currency to be received by the recipient.

payOutstring

Mechanism we use to deliver the transfer. Not usually of interest to the user.

preferredPayInstring

Preferred pay-in method.

ratenumber

Exchange rate value used for the conversion.

createdTimestring date-time

Quote created timestamp.

userinteger

User ID who created the quote.

profileinteger

Personal or business profile ID.

rateType'FIXED' | 'FLOATING'

Whether the rate is fixed or floating.

rateExpirationTimestring date-time

Time the locked rate will expire.

guaranteedTargetAmountAllowedboolean

Whether guaranteed target amount is allowed.

targetAmountAllowedboolean

Whether target amount is allowed.

guaranteedTargetAmountboolean

Whether the target amount is guaranteed.

providedAmountType'SOURCE' | 'TARGET'

Whether the quote was created as source or target.

status'PENDING' | 'ACCEPTED' | 'FUNDED' | 'EXPIRED'

Current status of this quote.

expirationTimestring date-time

The time the quote expires.

Example response

{
  "id": "11144c35-9fe8-4c32-b7fd-d05c2a7734bf",
  "sourceCurrency": "GBP",
  "targetCurrency": "USD",
  "sourceAmount": 100,
  "targetAmount": 129.24,
  "payOut": "BANK_TRANSFER",
  "preferredPayIn": "BANK_TRANSFER",
  "rate": 1.30445,
  "createdTime": "2019-04-05T13:18:58Z",
  "user": 55,
  "profile": 101,
  "rateType": "FIXED",
  "rateExpirationTime": "2019-04-08T13:18:57Z",
  "guaranteedTargetAmountAllowed": true,
  "targetAmountAllowed": true,
  "providedAmountType": "SOURCE",
  "pricingConfiguration": {
    "fee": {
      "type": "OVERRIDE",
      "variable": 0.011,
      "fixed": 15.42
    }
  },
  "paymentOptions": [
    {
      "estimatedDelivery": "2019-04-08T12:30:00Z",
      "formattedEstimatedDelivery": "by Apr 8",
      "estimatedDeliveryDelays": [
        {
          "reason": "sample reason"
        }
      ],
      "fee": {
        "transferwise": 3.04,
        "discount": 2.27,
        "total": 0.77
      },
      "price": {
        "priceSetId": 238,
        "total": {
          "type": "TOTAL",
          "label": "Total fees",
          "value": {
            "amount": 0.77,
            "currency": "GBP",
            "label": "0.77 GBP"
          }
        },
        "items": [
          {
            "type": "FEE",
            "label": "fee",
            "value": {
              "currency": "GBP",
              "label": "0 GBP"
            }
          }
        ],
        "deferredFee": {
          "amount": 14.79,
          "currency": "BRL"
        },
        "calculatedOn": {
          "unroundedAmountToConvert": {
            "amount": 179.97342,
            "currency": "BRL"
          }
        }
      },
      "sourceAmount": 100,
      "targetAmount": 129.24,
      "sourceCurrency": "GBP",
      "targetCurrency": "USD",
      "payIn": "BANK_TRANSFER",
      "payOut": "BANK_TRANSFER",
      "allowedProfileTypes": [
        "PERSONAL",
        "BUSINESS"
      ],
      "payInProduct": "CHEAP",
      "feePercentage": 0.0092
    }
  ],
  "status": "PENDING",
  "expirationTime": "2019-04-05T13:48:58Z",
  "notices": [
    {
      "text": "You can have a maximum of 3 open transfers with a guaranteed rate. After that, they'll be transferred using the live rate. Complete or cancel your other transfers to regain the use of guaranteed rate.",
      "type": "WARNING"
    }
  ]
}