Skip to content

Request a comparison quote

Request

Request price and speed comparison data for money transfer providers on a given currency route.

You must provide either sendAmount or recipientGetsAmount (but not both).

Query
sourceCurrencystringrequired

ISO 4217 source currency code

Example:sourceCurrency=GBP
targetCurrencystringrequired

ISO 4217 target currency code

Example:targetCurrency=EUR
sendAmountnumber

Amount to send in source currency. Must provide either sendAmount or recipientGetsAmount.

Example:sendAmount=10000
recipientGetsAmountnumber

Amount to be received in target currency. Must provide either sendAmount or recipientGetsAmount.

midMarketRatenumber

Current mid-market rate between the source and target currency

wiseFeenumber

Wise's fee, if the Wise quote is known

wiseEstimatedDeliverystring

Wise's estimated delivery timestamp, if the Wise quote is known

wiseQuoteCreatedTimestring

Timestamp when the Wise quote was created

payInMethodstring

Change the pay-in method of the Wise quote only (all other quotes will remain as bank transfer)

sourceCountrystring

Filter by source country (ISO 3166-1 Alpha-2 code)

targetCountrystring

Filter by target country (ISO 3166-1 Alpha-2 code)

providerCountrystring

Filter by provider country (ISO 3166-1 Alpha-2 code)

filterstring

Filter by most popular competitors

Value:"POPULAR"
numberOfProvidersinteger, (int32)

Number of popular competitors to return if filter is set to POPULAR - default value is 4

providerTypesArray of strings

Filter by provider type

Items Enum:"bank""moneytransferprovider""travelMoney"
providersstring

Filter by specific provider aliases

excludePartnersboolean

Exclude Wise's partner banks - default true

includeWiseboolean

Overrides filters to ensure Wise data is returned, even if exclusionary filters are applied

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/v4/comparisons?sourceCurrency=GBP&targetCurrency=EUR&sendAmount=10000&recipientGetsAmount=0&midMarketRate=0&wiseFee=0&wiseEstimatedDelivery=string&wiseQuoteCreatedTime=string&payInMethod=string&sourceCountry=string&targetCountry=string&providerCountry=string&filter=POPULAR&numberOfProviders=0&providerTypes=bank&providers=string&excludePartners=true&includeWise=true' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479'

Responses

Comparison data retrieved successfully.

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
sourceCurrencystring or null

ISO 4217 source currency code

Example:"GBP"
targetCurrencystring or null

ISO 4217 target currency code

Example:"EUR"
sourceCountrystring or null

Source country (ISO 3166-1 Alpha-2 code)

Example:null
targetCountrystring or null

Target country (ISO 3166-1 Alpha-2 code)

Example:null
providerCountrystring or null

Provider country (ISO 3166-1 Alpha-2 code)

Example:null
providerTypesArray of strings

List of provider types included in the response

Example:
[
  "bank",
  "moneyTransferProvider"
]
amountnumber

The comparison amount

Example:10000
amountTypestring

Whether the amount represents a send amount or recipient gets amount

Example:"SEND"
providersArray of objects

List of providers with their estimated quotes

property name*anyadditional property
Response
{
  "sourceCurrency": "GBP",
  "targetCurrency": "EUR",
  "sourceCountry": null,
  "targetCountry": null,
  "providerCountry": null,
  "providerTypes": [
    "bank",
    "moneyTransferProvider"
  ],
  "amount": 10000,
  "amountType": "SEND",
  "providers": [
    {
      "id": 39,
      "alias": "wise",
      "name": "Wise",
      "logos": { … },
      "type": "moneyTransferProvider",
      "partner": false,
      "quotes": [ … ]
    },
    {
      "id": 1,
      "alias": "barclays",
      "name": "Barclays",
      "logos": { … },
      "type": "bank",
      "partner": false,
      "quotes": [ … ]
    }
  ]
}