---
title: "Read all Currency Exchange Rates"
method: GET
path: "/channel/v1/exchangeRates"
tags: ["CurrencyExchangeRate"]
---

# Read all Currency Exchange Rates

`GET /channel/v1/exchangeRates`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/channel/v1/exchangeRates`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/channel/v1/exchangeRates/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all of the current and historical exchange rates set on the marketplace.

## Query parameters

- `baseCurrency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ'
- `counterCurrency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ'
- `page` integer
- `size` integer
- `sortField` 'BASE_CURRENCY' | 'COUNTER_CURRENCY' | 'VALID_FROM'
- `sortOrder` 'ASC' | 'DESC'

## Response `200`

OK

- CurrencyExchangeRateResponseList, nullable: Resource links
  - `links` Link[]: Resource links
    - `href` string
    - `rel` string
  - `content` CurrencyExchangeRateResponse[]
    - `baseCurrency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ' | 'IDR' | 'ARS' | 'COP' | 'PEN': Supported currencies for the system
    - `counterCurrency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ' | 'IDR' | 'ARS' | 'COP' | 'PEN': Supported currencies for the system
    - `rate` number: A currency pair is the quotation and pricing structure of the currencies traded in a forex market. A Currency Pair is represented as XXX/YYY where XXX is the Base currency and YYY is the Counter currency. In AppDirect the Base currency is an external currency and the Counter currency is a supported currency in your marketplace. When an exchange rate is provided with a Currency Pair, it represents how much of the Counter currency is required to purchase 1 unit of the Base currency. EUR/USD=1.18; EUR is the Base currency and USD is the counter currency. 1 EUR is equal to 1.18 USD. In order to buy 1 EUR, the buyer must pay 1.18 USD.
    - `validFrom` number: Date from which the rate is valid
    - `active` boolean: Whether or not the exchange rate is active and can be used in a conversion event
    - `authenticationType` string: The type of authentication used to create or change an exchange rate instance
    - `oauthKey` string: The oauth key used to create or change an exchange rate instance
    - `userId` number: The user id of the user who created or changed an exchange rate instance
    - `currencyExchangeRateUuid` string: Unique identifier for the object
  - `page` PagedResource
    - `totalPages` number
    - `number` number
    - `size` number
    - `totalElements` number

## Other responses

- `404`: Not Found

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/channel/v1/exchangeRates/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)