---
title: "getTransferPreview"
method: GET
path: "/finances/transfers/wallet/2024-03-01/transferPreview"
tags: ["Seller Wallet v2024-03-01"]
---

# getTransferPreview

`GET /finances/transfers/wallet/2024-03-01/transferPreview`

Retrieve a list of potential fees on a transaction.

## Query parameters

- `sourceCountryCode` string, required
- `sourceCurrencyCode` string, required
- `destinationCountryCode` string, required
- `destinationCurrencyCode` string, required
- `baseAmount` number, required
- `marketplaceId` string, required

## Response `200`

Success

- TransferRatePreview — The fees and foreign exchange rates that apply to the transaction. If the fees are in terms of the `baseAmount` (source account) currency, then the effective rate is equal to **1 - (fees * `baseRate` / `baseAmount`)**. If the fees are in terms of the `transferAmount` (destination account) currency, then the effective rate is equal to **`baseRate` - (fees / `baseAmount`)**. In the preceding expressions, **fees** is equal to the sum of all `feeAmount.currencyAmount` values in the `fees` array.
  - `baseAmount` Currency, required — A currency type and amount.
    - `currencyCode` string — The three-digit currency code in ISO 4217 format.
    - `currencyAmount` number — A decimal number, such as an amount or FX rate.
  - `fxRateDetails` FxRateDetails, required — Foreign exchange rate details.
    - `fxRateId` string, required — The unique identifier assigned to the fees / foreign exchange rate of a transaction.
    - `baseRate` number, required — A decimal number, such as an amount or FX rate.
    - `effectiveFxRate` number, required — A decimal number, such as an amount or FX rate.
    - `rateDirection` 'BUY' | 'SELL', required — Whether the customer is buying or selling the source currency.
  - `transferAmount` Currency, required — A currency type and amount.
    - `currencyCode` string — The three-digit currency code in ISO 4217 format.
    - `currencyAmount` number — A decimal number, such as an amount or FX rate.
  - `fees` Fee[], required — A list of fees.
    - `feeId` string, required — The unique identifier assigned to the fee.
    - `feeType` 'MISCELLANEOUS_FEE' | 'TAX' | 'TRANSACTION_FEE', required — The type of fee on the transaction.
    - `feeRateValue` string, required — The value of the fee in percentage format.
    - `feeAmount` Currency, required — A currency type and amount.
      - `currencyCode` string — The three-digit currency code in ISO 4217 format.
      - `currencyAmount` number — A decimal number, such as an amount or FX rate.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `408` — Request Timed Out.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)