---
title: "Convert currency using dynamic rates"
method: POST
path: "/v1/currency-converter/effective"
tags: ["Currency Conversion"]
---

# Convert currency using dynamic rates

`POST /v1/currency-converter/effective`

Convert currency using the rates Remote applies during employment creation and invoicing.

## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage company resources (`company_admin`) | Convert currencies (`convert_currency:read`) | - |

## Request body

- ConvertCurrencyParams — The parameters for the currency conversion
  - `amount` integer, required — The amount to convert in cents
  - `source_currency` string, required — The currency code to convert from
  - `target_currency` string, required — The currency code to convert to

## Response `200`

Success

- ConvertCurrencyResponse — The response from the currency converter
  - `data` object, required
    - `conversion_data` ConvertCurrency, required — The response from the currency converter
      - `exchange_rate` number, required — The exchange rate used to convert the amount
      - `source_amount` integer, required — The amount in cents in the source currency
      - `source_currency` CurrencyDefinition, required — Currency object without a UUID identifier
        - `code` string, required
        - `name` string, required
        - `symbol` string, required
      - `target_amount` integer, required — The amount in cents in the target currency
      - `target_currency` CurrencyDefinition, required — Currency object without a UUID identifier
        - `code` string, required
        - `name` string, required
        - `symbol` string, required

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)