---
title: "Get Currency Exchange Rate"
method: GET
path: "/v3/exchange_rates"
tags: ["Exchange Rates"]
---

# Get Currency Exchange Rate

`GET /v3/exchange_rates`

The `exchange_rates` endpoint allows you to get the exchange of any currency compared against USD.
You need to specify a country ISO code and optionally an amount in USD.
If no amount is specified, 1 USD will be assumed.
Please find all the country codes in the Countries Specifications section.

## Query parameters

- `country` string, required
- `amount` number, float

## Headers

- `Content-Type` string, required
- `X-Date` string, date-time, required
- `X-Login` string, required
- `Authorization` string, required
- `X-Idempotency-Key` string

## Response `200`

Currency exchange correctly returned.

- ExchangeRateResponse — Schema for the successful currency exchange response.
  - `fx_rate` number, float — Currency exchange rate.
  - `currency` string — Currency used for the conversion.
  - `converted_amount` number, float — Amount resulting from multiplying the amount you sent with the fx_rate.

## Other responses

- `400` — The country specified was incorrect.
- `401` — Invalid credentials error.

---

[API](https://skmtc.dev/d24/apis/docs-d24-com.md) · [All operations](https://skmtc.dev/d24/apis/docs-d24-com/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/d24/docs-d24-com/revisions/fb0e2ddec198/schema)