v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

comparison

Request a comparison quote

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).

get/v4/comparisons

Query parameters

sourceCurrencystring required

ISO 4217 source currency code

targetCurrencystring required

ISO 4217 target currency code

sendAmountnumber

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

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)

filter'POPULAR'

Filter by most popular competitors

numberOfProvidersinteger

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

providerTypesstring[]

Filter by provider type

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

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Response

Comparison data retrieved successfully.

sourceCurrencystring nullable

ISO 4217 source currency code

targetCurrencystring nullable

ISO 4217 target currency code

sourceCountrystring nullable

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

targetCountrystring nullable

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

providerCountrystring nullable

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

providerTypesstring[]

List of provider types included in the response

amountnumber

The comparison amount

amountTypestring

Whether the amount represents a send amount or recipient gets amount

Example response

{
  "sourceCurrency": "GBP",
  "targetCurrency": "EUR",
  "providerTypes": [
    "bank",
    "moneyTransferProvider"
  ],
  "amount": 10000,
  "amountType": "SEND",
  "providers": [
    {
      "id": 39,
      "alias": "wise",
      "name": "Wise",
      "logos": {
        "normal": {
          "svgUrl": "https://wise.com/public-resources/assets/logos/wise-personal/logo.svg",
          "pngUrl": "https://wise.com/public-resources/assets/logos/wise-personal/logo.png"
        },
        "inverse": {
          "svgUrl": "https://wise.com/public-resources/assets/logos/wise-personal/logo_inverse.svg",
          "pngUrl": "https://wise.com/public-resources/assets/logos/wise-personal/logo_inverse.png"
        },
        "white": {
          "svgUrl": "https://wise.com/public-resources/assets/logos/wise-personal/logo_white.svg",
          "pngUrl": "https://wise.com/public-resources/assets/logos/wise-personal/logo_white.png"
        },
        "circle": {
          "svgUrl": "https://dq8dwmysp7hk1.cloudfront.net/logos/wise-mark.svg"
        },
        "altText": "Wise"
      },
      "type": "moneyTransferProvider",
      "quotes": [
        {
          "rate": 1.15989,
          "fee": 37.12,
          "dateCollected": "2019-10-22T14:36:43Z",
          "receivedAmount": 11555.84,
          "isConsideredMidMarketRate": true,
          "deliveryEstimation": {
            "duration": {
              "min": "PT20H8M16.305111S",
              "max": "PT20H8M16.305111S"
            },
            "providerGivesEstimate": true
          }
        }
      ]
    }
  ]
}