---
title: "View a Quote"
method: GET
path: "/v2.01/{ClientId}/conversions/quote/{QuoteId}"
tags: ["Quotes"]
---

# View a Quote

`GET /v2.01/{ClientId}/conversions/quote/{QuoteId}`

View a Quote

## Path parameters

- `ClientId` string, required
- `QuoteId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- ViewAQuoteResponse
  - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
  - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
  - `ExpirationDate` integer — Unix timestamp (UTC) of the date and time the quote expires and can no longer be used.
  - `Status` string — **Returned values:** `ACTIVE`, `EXPIRED` The status of the quote: - `ACTIVE` – The quote can be used to execute a quoted conversion. - `EXPIRED` – The quote can't be used because the `ExpirationDate` is passed.
  - `DebitedFunds` ViewAQuoteResponseDebitedFunds — Information about the debited funds.
    - `Currency` string — **Allowed 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 currency of the amount.
    - `Amount` integer — An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as `1260` whereas JPY 12 would be represented as just `12`). During a conversion, (`DebitedFunds.Amount` - `Fees`) * `MarketRate` = `CreditedFunds.Amount`.
  - `CreditedFunds` ViewAQuoteResponseCreditedFunds — Information about the credited funds.
    - `Currency` string — **Allowed 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 currency of the amount.
    - `Amount` integer — An amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as `1260` whereas JPY 12 would be represented as just `12`). During a conversion, `CreditedFunds.Amount` = (`DebitedFunds.Amount` - `Fees`) * `MarketRate`.
  - `Fees` FeesConversionResponse — Information about the fees taken by the platform for this transaction (and hence transferred to the Fees Wallet). **Note:** The fees currency must match the debited funds currency.
    - `Currency` string — **Allowed 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 currency of the amount.
    - `Amount` integer — The amount of the currency in its minor unit. For example, EUR 12.60 would be represented as `1260` whereas JPY 12 would be represented as just `12`.
  - `ConversionRateResponse` ConversionRateResponse — Information about the `MarketRate` used to convert funds and other indicative rates.
    - `ClientRate` number, double — Max. 7 decimal places The indicative rate including Mangopay's markup, used during the billing cycle: `ClientRate` = `MarketRate` * (1 - `MarginsResponse.Mangopay`). The `MarginsResponse.Mangopay.Amount` gives the amount of debited currency that will be billed by Mangopay to your platform for the transaction. The `ClientRate` fluctuates in line with the `MarketRate`.
    - `MarketRate` number, double — Max. 7 decimal places The rate used to convert funds during the 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.
    - `FinalRate` number, double — Max. 7 decimal places The indicative rate including the `UserMargin`, if your platform defined it in the request or the quote: `FinalRate` = `ClientRate` * (1 - `MarginsResponse.User`). The `MarginsResponse.User.Amount` gives the amount of debited currency that your platform could bill to the user for the transaction. If no `UserMargin` was included, the `FinalRate` is the same as the `ClientRate`.
  - `RequestedFees` RequestedFeesConversion — Information about the `Fees` sent in the request.
    - `Type` string — **Allowed values:** `PERCENTAGE`, `FIXED` **Default value:** `FIXED` The type of the `Value`.
    - `Value` integer — The value to be used for the `Type`: - `PERCENTAGE` – In quantities of 0.1% (e.g. `150` equals 1.5%), the percentage of `DebitedFunds.Amount` deducted as fees. - `FIXED` – The amount deducted from `DebitedFunds.Amount` as fees, as an amount of money in the smallest sub-division of the currency (e.g., EUR 12.60 would be represented as `1260` whereas JPY 12 would be represented as just `12`).
    - `Currency` string — **Allowed 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 currency of the fees, which must match the debited currency.
  - `MarginsResponse` MarginsResponse — Information about the margins calculated for the transaction.
    - `Mangopay` MarginsResponseMangopay — The margin used by Mangopay to bill your platform (which is defined during contracting).
      - `Type` string — **Response value:** `PERCENTAGE` The type of the `Value`, which for Mangopay is always `PERCENTAGE`.
      - `Value` number, double — The value to be used for the `Type`. Mangopay's markup is expressed as a percentage (to convert to decimal, divide by 100).
      - `Amount` integer — The amount of debited currency that Mangopay will charge your platform for the transaction during the billing cycle.
    - `User` MarginsResponseUser — The margin your platform could use to bill the user, as calculated by `UserMargin` in the request or quote (otherwise `null` if not set).
      - `Type` string — **Response values:** `PERCENTAGE`, `PIP` The type of the `Value`.
      - `Value` number, double — The value to be used for the `Type`: - `PERCENTAGE` – The quantities of 1% used to calculate the user margin. - `PIP` – The quantities of `0.0001` (one pip) used to calculate the user margin.
      - `Amount` integer — The amount of debited currency that your platform could bill to the user for the transaction.
  - `Tag` string — Max. length: 255 characters Custom data that you can add to this object.
  - `Duration` integer — **Allowed values:** `300`, `3600` The time in seconds during which the quote is active and can be used for conversions. By default, quotes are available for a duration of 5 or 60 minutes, as agreed between Mangopay and the platform.

---

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