---
title: "List exchange rates"
method: GET
path: "/currency_exchange_rates"
tags: ["Currency Exchange Rate"]
---

# List exchange rates

`GET /currency_exchange_rates`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/currency_exchange_rates`
- Auth: HTTP bearer

Returns a [cursor-paginated](https://docs.gocardless.com/docs/api-reference/data-conventions#cursor-pagination) list of all exchange rates.

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string
- `source` string: Source currency
- `target` string: Target currency

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- CurrencyExchangeRateMultiResourceResponse
  - `currency_exchange_rates` CurrencyExchangeRate[]
    - `source` string, required: Source currency
    - `target` string, required: Target currency
    - `rate` string, required: The exchange rate from the source to target currencies provided with up to 10 decimal places.
    - `time` string, date-time, required: Time at which the rate was retrieved from the provider.
  - `meta` CurrencyExchangeRatePaginationMeta: Cursor pagination information
    - `limit` integer, required
    - `cursors` object, required
      - `before` string, nullable, required: Cursor pointing to the end of the desired set.
      - `after` string, nullable, required: Cursor pointing to the start of the desired set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

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