---
title: "Return org custom exchange rates"
method: GET
path: "/v1/org/{orgId}/exchange-rate/{date}/history"
tags: ["exchange-rate"]
---

# Return org custom exchange rates

`GET /v1/org/{orgId}/exchange-rate/{date}/history`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/org/{orgId}/exchange-rate/{date}/history`
- Auth: none declared

## Path parameters

- `orgId` string, required
- `date` string, date, required

## Query parameters

- `currency` string, required
- `fromDate` string, date, required
- `toDate` string, date, required

## Response `200`

successful operation

- ExchangeRate[]
  - `id` string, required: globally unique id
  - `orgId` string: org id, if an org-specific exchange rate is in use
  - `date` string, date, required: date
  - `currency` string, required: base currency
  - `rates` object, required: exchange rates, per currency - the multiplier to convert the base currency into the foreign currency
  - `updateAt` string: updated timestamp

## Other responses

- `400`: bad request
- `401`: not authorized
- `404`: not found

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) - [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/e487d45ac256?raw)
