---
title: "View an indicative Conversion Rate"
method: GET
path: "/v2.01/{ClientId}/conversions/rate/{DebitedCurrency}/{CreditedCurrency}"
tags: ["conversionRates"]
---

# View an indicative Conversion Rate

`GET /v2.01/{ClientId}/conversions/rate/{DebitedCurrency}/{CreditedCurrency}`

<Note icon="fa-regular fa-circle-info"> 
**Note – Rate is not guaranteed** 

The rate returned by the API is indicative of the rate offered by Mangopay, but it is not a guaranteed rate. For quoted conversions, the rate is guaranteed by the quote. For instant conversions, the rate is displayed in the response.
</Note>

View an indicative Conversion Rate

Learn more about FX **&rarr;**

## Path parameters

- `ClientId` string, required
- `DebitedCurrency` string, required
- `CreditedCurrency` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- ViewAnIndicativeConversionRateResponse
  - `DebitedCurrency` string — **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings). The sell currency (the currency of the debited wallet during a conversion).
  - `CreditedCurrency` string — **Returned values:** The three-letter <a href="/api-reference/overview/data-formats" target="_blank">ISO 4217 code</a> (EUR, GBP, etc.) of a <a href="/guides/currencies" target="_blank">supported currency</a> (depends on feature, contract, and activation settings). The buy currency (the currency of the credited wallet during a conversion).
  - `ClientRate` number, double — Max. 7 decimal places The rate including Mangopay’s markup, indicative of the rate invoiced during the billing cycle: `ClientRate` = `MarketRate` * (1 - markup). The `ClientRate` fluctuates in line with the `MarketRate`.
  - `MarketRate` number, double — Max. 7 decimal places The rate used to convert funds during a conversion: (`DebitedFunds.Amount` - `Fees`) * `MarketRate` = `CreditedFunds.Amount`. The market rate fluctuates in line with FX market dynamics and is common to all platforms for the currency pair.
  - `MarketRateDate` integer — The date and time at which the market rate was retrieved.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/mangopay/apis/api-reference.md) · [All operations](https://skmtc.net/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mangopay/api-reference/versions/795281070285/schema)