---
title: "List Global Currency Exchange Rates records"
method: GET
path: "/v1/data/global-currency-exchange-rates"
tags: ["Currency Exchange Rates"]
---

# List Global Currency Exchange Rates records

`GET /v1/data/global-currency-exchange-rates`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/global-currency-exchange-rates`
- Auth: none declared. Required headers: `X-API-Key`

List Global Currency Exchange Rates records with optional filters and pagination.

**Source:** Source: U.S. Department of the Treasury, Fiscal Data (fiscaldata.treasury.gov) (Public domain (US Government work, free to use per Fiscal Data licence)).

**Fields returned:**
- `record_date` (date) — Date the rate was published in the Treasury report
- `country` (str) — Country or issuing authority of the currency
- `currency` (str) — Currency name, for example Dollar or Euro
- `country_currency_desc` (str) — Combined country and currency label, for example Australia-Dollar
- `exchange_rate` (float) — Units of the foreign currency per one US dollar
- `effective_date` (date) — Date from which the rate applies
- `record_calendar_year` (int) — Calendar year of the published rate
- `record_calendar_month` (int) — Calendar month of the published rate

**Example:** `GET /v1/data/global-currency-exchange-rates?limit=10&country=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `country` string, nullable: Country or issuing authority of the currency
- `currency` string, nullable: Currency name, for example Dollar or Euro
- `record_date` string, nullable: Date the rate was published in the Treasury report
- `effective_date` string, nullable: Date from which the rate applies
- `record_calendar_year` string, nullable: Calendar year of the published rate

## Headers

- `X-API-Key` string, required

## Response `200`

A page of Global Currency Exchange Rates records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

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