---
title: "Fetch Exchange Rates"
method: GET
path: "/v3/fx/payout"
---

# Fetch Exchange Rates

`GET /v3/fx/payout`

Retrieve exchange rate between currency pairs

## Query parameters

- `initial_currency` string, required
- `final_currency` string, required
- `amount` string

## Response `200`

200

- object
  - `status` string — Indicates whether the FX conversion request was successful.
  - `message` string — Additional information about the FX conversion operation, if any.
  - `data` object — Contains detailed information about the currency conversion result.
    - `amount` number — The amount that needs to be exchanged
    - `converted_amount` integer — The amount converted into the final currency, expressed in the smallest currency unit (e.g., cents).
    - `exchange_rate` number — The exchange rate applied for converting from the initial to the final currency.
    - `final_currency` string — The target currency after conversion (ISO 4217 format).
    - `initial_currency` string — The source currency before conversion (ISO 4217 format).
    - `timestamp` string — Timestamp indicating when the FX conversion was performed (ISO 8601 format).

---

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