FIfirefly-iii
currency_exchange_rates

Update existing currency exchange rate.

Used to update a single currency exchange rate by its currency codes and date

put/v1/exchange-rates/{from}/{to}/{date}

Request

  • Base URL
    https://demo.firefly-iii.org/api
  • URL
    https://demo.firefly-iii.org/api/v1/exchange-rates/{from}/{to}/{date}
  • Auth
    • OAuth 2
      Authorization code: https://demo.firefly-iii.org/oauth/authorize
      Token URL: https://demo.firefly-iii.org/oauth/token
    • or HTTP bearer

Path parameters

fromstring required
Example:EUR

The currency code of the 'from' currency.

tostring required
Example:USD

The currency code of the 'to' currency.

datestring string required

Headers

X-Trace-Idstring uuid
Example:40c71bbb-c676-4f24-83cf-cc725d7d7a00

Unique identifier associated with this request.

Request body

ratestring string required

The exchange rate from the base currency to the destination currency.

Example request

{
  "rate": "2.3456"
}

Response

Updated exchange rate stored, result in response

Example response

{
  "data": {
    "type": "currency_exchange_rates",
    "id": "2",
    "attributes": {
      "created_at": "2025-12-01T00:00:00+00:00",
      "updated_at": "2025-12-01T00:00:00+00:00",
      "from_currency_id": "12",
      "from_currency_name": "Euro",
      "from_currency_code": "EUR",
      "from_currency_symbol": "$",
      "from_currency_decimal_places": 2,
      "to_currency_id": "12",
      "to_currency_name": "EUR",
      "to_currency_code": "EUR",
      "to_currency_symbol": "$",
      "to_currency_decimal_places": 2,
      "rate": "1.10340",
      "date": "2025-12-01T00:00:00+00:00"
    },
    "links": {
      "0": {
        "rel": "self",
        "uri": "/OBJECTS/1"
      },
      "self": "https://demo.firefly-iii.org/api/v1/OBJECTS/1"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.