---
title: "Simulate FX-Conversion by ID"
method: PATCH
path: "/fx-conversion/simulate"
tags: ["FX-Conversion"]
---

# Simulate FX-Conversion by ID

`PATCH /fx-conversion/simulate`

## Request

- Base URL: `https://api.finmo.net/v1`
- URL: `https://api.finmo.net/v1/fx-conversion/simulate`
- Auth: HTTP basic

Use this Method in the sandbox to simulate the completion of the FX-Conversion.

To complete the FX-Conversion, it must be in a ```PENDING``` status. Upon successful execution of this API, the FX-Conversion status updates to ```COMPLETED``` or ```CANCELLED```. You will receive a ```406``` error if the FX-Conversion is not in a ```PENDING``` status or if you attempt to complete an already completed or cancelled FX-Conversion.

Finmo does not support the cancellation of FX-Conversions at the moment. The platform operates on a good funds model, which always checks the balance in the source currency before proceeding. Additionally, cancellation based on spot rates could result in a loss due to fluctuating FX rates.

## Headers

- `x-env` string, required

## Request body

- object
  - `fx_conversion_id` string, required: FX conversion reference (fx_conv_*)
  - `status` string: The status you want to simulate it to. If not passed the default value is taken as COMPLETED

## Response `200`

OK

- object
  - `data` object
    - `completed_at` string, date-time
    - `convert_at` string, date-time
    - `created_at` string, date-time
    - `credit_transaction_id` string
    - `credit_wallet_id` string
    - `credit_wallet_transaction_id` string
    - `customer_id` string
    - `debit_transaction_id` string
    - `debit_wallet_id` string
    - `debit_wallet_transaction_id` string
    - `fixed_side` string
    - `fx_conversion_id` string
    - `fx_rate` number
    - `fx_rate_id` string
    - `invoice_id` string
    - `metadata` string, nullable
    - `org_id` string
    - `organization_reference_id` string
    - `scope` string
    - `settle_by` string
    - `source_amount` integer
    - `source_currency` string
    - `status` string
    - `target_amount` number
    - `target_currency` string
    - `updated_at` string, date-time
    - `webhook_url` string, uri, nullable
  - `request_id` string
  - `request_time` string, date-time
  - `status_code` integer
  - `status_text` string
  - `success` boolean

## Other responses

- `404`: Not Found
- `406`: Not Acceptable

## Changes

- **2026-11-03** `39e5e5ab5c3a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/finmo/apis/finmo-api/changes/fx-conversion/simulate/patch.md)

---

[API](https://skmtc.dev/finmo/apis/finmo-api.md) - [All operations](https://skmtc.dev/finmo/apis/finmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/finmo/apis/finmo-api/revisions/39e5e5ab5c3a?raw)