---
title: "View a Conversion"
method: GET
path: "/v2.01/{ClientId}/conversions/{ConversionId}"
tags: ["Conversions"]
---

# View a Conversion

`GET /v2.01/{ClientId}/conversions/{ConversionId}`

<Note icon="fa-regular fa-circle-info"> 
**Note – Conversion data retained for 13 months**

An API call to retrieve a conversion whose `CreationDate` is older than 13 months may return 404 Not Found.

For more information, see the <a href="/api-reference/overview/data-availability-periods">Data availability periods</a> article.
</Note>

View a Conversion

All conversions returned by this endpoint contain the `QuoteId` parameter. For instant conversions, it is `null`.

## Path parameters

- `ClientId` string, required
- `ConversionId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- ConversionResponse
  - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
  - `QuoteId` string, nullable — The unique identifier of the active quote which guaranteed the rate for the conversion. Returned `null` in the case of an instant conversion.
  - `Type` string — **Returned values:** `PAYIN`, `TRANSFER`, `CONVERSION`, `PAYOUT` The type of the transaction.
  - `Nature` string — **Returned values:** `REGULAR`, `REPUDIATION`, `REFUND`, `SETTLEMENT` The nature of the transaction, providing more information about the context in which the transaction occurred: - `REGULAR` – Relative to most of the transactions (pay-ins, payouts, and transfers) in a usual workflow. - `REPUDIATION` – Automatic withdrawal of funds from the platform's repudiation wallet as part of the dispute process (when the user has requested a chargeback). - `REFUND` – Reimbursement of a transaction to the user (pay-in refund), to a wallet (transfer refund), or of a payout (payout refund, only initiated by Mangopay). - `SETTLEMENT` – Transfer made to the repudiation wallet by the platform to settle a lost dispute.
  - `CreationDate` integer — Unix timestamp (UTC) of the date and time the object was created.
  - `Status` string — **Returned values:** `CREATED`, `SUCCEEDED`, `FAILED` The status of the transaction.
  - `AuthorId` string — The unique identifier of the user at the source of the transaction. In a conversion, both the debited and credited wallets are owned by the author.
  - `DebitedWalletId` string — The unique identifier of the debited wallet (in the sell currency).
  - `CreditedWalletId` string — The unique identifier of the credited wallet (in the buy currency).
  - `DebitedFunds` ConversionResponseDebitedFunds — 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` ConversionResponseCreditedFunds — 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`.
  - `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.
  - `ResultCode` string — The code indicating the result of the operation. This information is mostly used to <a href="/errors/codes">handle errors</a> or for filtering purposes.
  - `ResultMessage` string — The explanation of the result code.
  - `ExecutionDate` integer — Unix timestamp (UTC) of the date and time the status changed to `SUCCEEDED`, indicating that the transaction occurred. The statuses `CREATED` and `FAILED` return an `ExecutionDate` of `null`.
  - `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`.
  - `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.

---

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