---
title: "Request a comparison quote"
method: GET
path: "/v4/comparisons"
tags: ["comparison"]
---

# Request a comparison quote

`GET /v4/comparisons`

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 parameters

- `sourceCurrency` string, required
- `targetCurrency` string, required
- `sendAmount` number
- `recipientGetsAmount` number
- `midMarketRate` number
- `wiseFee` number
- `wiseEstimatedDelivery` string
- `wiseQuoteCreatedTime` string
- `payInMethod` string
- `sourceCountry` string
- `targetCountry` string
- `providerCountry` string
- `filter` 'POPULAR'
- `numberOfProviders` integer
- `providerTypes` string[]
- `providers` string
- `excludePartners` boolean
- `includeWise` boolean

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

Comparison data retrieved successfully.

- Comparison — V4 comparison response containing price and speed estimates from various money transfer providers.
  - `sourceCurrency` string, nullable — ISO 4217 source currency code
  - `targetCurrency` string, nullable — ISO 4217 target currency code
  - `sourceCountry` string, nullable — Source country (ISO 3166-1 Alpha-2 code)
  - `targetCountry` string, nullable — Target country (ISO 3166-1 Alpha-2 code)
  - `providerCountry` string, nullable — Provider country (ISO 3166-1 Alpha-2 code)
  - `providerTypes` string[] — List of provider types included in the response
  - `amount` number — The comparison amount
  - `amountType` string — Whether the amount represents a send amount or recipient gets amount
  - `providers` object[] — List of providers with their estimated quotes
    - `id` integer — Provider ID
    - `alias` string — Provider alias (lowercase slug name)
    - `name` string — Provider name (presentational / formal name)
    - `logos` object — URLs pointing to provider logos (svg, png)
      - `normal` object
        - `svgUrl` string, nullable
        - `pngUrl` string, nullable
      - `inverse` object
        - `svgUrl` string, nullable
        - `pngUrl` string, nullable
      - `white` object
        - `svgUrl` string, nullable
        - `pngUrl` string, nullable
      - `circle` object
        - `svgUrl` string, nullable
        - `pngUrl` string, nullable
      - `altText` string — Alt text for the provider logo
    - `type` string — Provider type: bank, money transfer provider, or travel money
    - `partner` boolean — Whether a partner of Wise or not
    - `quotes` object[] — An array of estimated quotes per provider
      - `rate` number — The live estimated exchange rate for the provider for this quote
      - `fee` number — The estimated fee for the provider for this quote
      - `dateCollected` string — The date of collection for the original quote
      - `sourceCountry` string, nullable — Source country (ISO 3166-1 Alpha-2 code)
      - `targetCountry` string, nullable — Target country (ISO 3166-1 Alpha-2 code)
      - `markup` number — Percentage markup on the quoted rate compared to the mid-market rate
      - `receivedAmount` number, nullable — The total estimated received amount for the provider for this quote (non-null only if a send amount request was made)
      - `sendAmount` number, nullable — The total estimated send amount for the provider for this quote (non-null only if a recipient gets amount request was made)
      - `isConsideredMidMarketRate` boolean — Whether the provider's rate is close enough to the true mid-market rate to be classified as a mid-market rate
      - `deliveryEstimation` object — Delivery estimation details - i.e. a speed estimate
        - `duration` object — Duration range
          - `min` string, nullable — Minimum quoted time for transaction delivery (ISO 8601 duration format)
          - `max` string, nullable — Maximum quoted time for transaction delivery (ISO 8601 duration format)
        - `providerGivesEstimate` boolean — Whether a provider publicly surfaces a speed estimate or not

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)