---
title: "Store a new currency exchange rate."
method: POST
path: "/v1/exchange-rates"
tags: ["currency_exchange_rates"]
---

# Store a new currency exchange rate.

`POST /v1/exchange-rates`

Stores a new exchange rate. The data required can be submitted as a JSON body or as a list of parameters.

## Headers

- `X-Trace-Id` string, uuid

## Request body

- CurrencyExchangeRateStore
  - `date` string, date, required — The date to which the exchange rate is applicable.
  - `from` string, string, required — The base currency code.
  - `to` string, string, required — The destination currency code.
  - `rate` string, string — The exchange rate from the base currency to the destination currency.

## Response `200`

New exchange stored, result in response. If a rate already exists for this currency pair and date, it will be updated.

## Other responses

- `400` — Bad request
- `401` — Unauthenticated
- `404` — Page not found
- `422` — Validation error. The body will have the exact details.
- `500` — Internal exception

---

[API](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-develop.md) · [All operations](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-develop/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firefly-iii/firefly-iii-api-develop/revisions/8a1f6472e04b/schema)