---
title: "List custom exchange rates by currency"
method: GET
path: "/v1/custom-exchange-rates/{currency}"
tags: ["Custom Exchange Rates"]
---

# List custom exchange rates by currency

`GET /v1/custom-exchange-rates/{currency}`

This feature is in **Limited Availability**. If you wish to have access to the feature, submit a request at [Zuora Global Support](http://support.zuora.com/). 

This reference describes how to query custom foreign exchange rates from Zuora. You can use this API method to query exchange rates only if you use a custom exchange rate provider and upload rates with the Import Foreign Exchange Rates mass action.

## Path parameters

- `currency` string, required

## Query parameters

- `startDate` string, required
- `endDate` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- GETCustomExchangeRatesType
  - `inverse` boolean — - If `true`, the exchange rate in the response is an inverse exchange rate. - If `false`, the exchange rate in the response is not an inverse exchange rate. The value is determined by the **Use inverse rate** checkbox in your Zuora Finance Manage Currency Conversion settings.
  - `rateSetName` string — The name of the exchange rate set. You can specify the exchange rate set only when **Exchange Rate Set** permission is available. To enable the **Exchange Rate Set** option, submit a request at [Zuora Global Support](http://support.zuora.com/).
  - `rates` object — Container for exchange rate data. Contains a set of fields that provide exchange rate data for each day between the specified `startDate` and `endDate` (inclusive).
  - `success` boolean — Returns `true` if the request was processed successfully.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)