Skip to main content
GET
/
{date}
Historical Rates for Date
curl --request GET \
  --url https://api.exchangeratesapi.com.au/{date} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "timestamp": 1725062400,
  "base": "AUD",
  "date": "2025-08-31",
  "rates": {
    "USD": 0.643512,
    "EUR": 0.562934,
    "GBP": 0.487421,
    "JPY": 96.832100,
    "CNY": 4.612340,
    "KRW": 859.123000,
    "INR": 54.123400,
    "SGD": 0.867890,
    "NZD": 1.094200,
    "THB": 22.567800,
    "MYR": 2.987650,
    "IDR": 9876.543000,
    "VND": 15678.900000,
    "HKD": 5.012340,
    "PHP": 36.789000,
    "CAD": 0.876540,
    "CHF": 0.567890,
    "TWD": 20.456700,
    "TWI": 60.500000,
    "SDR": 0.487650
  }
}

​
Overview

The historical date endpoint returns all available exchange rates for a specific date in the past. This is perfect when you need all currency rates for a particular day, such as for invoice calculations, reporting, or compliance purposes.
This endpoint requires authentication. Get your API key to start making requests.

​
Authentication

​
Authorization
string
required
Bearer token with your API key: Bearer your_api_key_here

​
Path Parameters

​
date
string
required
Date in YYYY-MM-DD format. Must be a valid date from 2018-01-01 onwards and not a weekend or Australian public holiday (when RBA doesn’t publish rates).Examples: 2025-08-31, 2024-12-31, 2023-06-15

​
Request

curl https://api.exchangeratesapi.com.au/2025-08-31 \
  -H "Authorization: Bearer your_api_key_here"

​
Response

{
  "success": true,
  "timestamp": 1725062400,
  "base": "AUD",
  "date": "2025-08-31",
  "rates": {
    "USD": 0.643512,
    "EUR": 0.562934,
    "GBP": 0.487421,
    "JPY": 96.832100,
    "CNY": 4.612340,
    "KRW": 859.123000,
    "INR": 54.123400,
    "SGD": 0.867890,
    "NZD": 1.094200,
    "THB": 22.567800,
    "MYR": 2.987650,
    "IDR": 9876.543000,
    "VND": 15678.900000,
    "HKD": 5.012340,
    "PHP": 36.789000,
    "CAD": 0.876540,
    "CHF": 0.567890,
    "TWD": 20.456700,
    "TWI": 60.500000,
    "SDR": 0.487650
  }
}

​
Response Fields

​
success
boolean
Indicates if the request was successful
​
timestamp
integer
Unix timestamp for the specified date (midnight UTC)
​
base
string
Base currency (always “AUD”)
​
date
string
The requested date in YYYY-MM-DD format
​
rates
object
Object containing all available currency codes and their exchange rates for the specified date

​
Response Headers

  • Cache-Control: no-store - Response should not be cached
  • X-Request-Id: <uuid> - Unique request identifier for debugging

​
Error Responses

{
  "success": false,
  "error": {
    "code": 400,
    "type": "bad_request",
    "info": "Invalid date format. Use YYYY-MM-DD"
  }
}

​
Rate Limits

This endpoint is subject to your plan’s monthly request limits:
PlanMonthly RequestsHistorical Access
Free300No historical data
Starter5,000Last 30 days
Professional50,000Full history (2018+)
Business500,000Full history (2018+)
Free Plan: No access to historical data
Starter Plan: Access to last 30 days of historical data
Paid Plans: Full access to all historical data from 2018 onwards

​
Historical Data Availability

​
Date Range

  • Available from: January 1, 2018
  • Updated daily: New rates published at 4:00 PM AEST by the RBA

​
Missing Dates

The RBA doesn’t publish exchange rates on:
  • Weekends: Saturday and Sunday
  • Australian Public Holidays: New Year’s Day, Australia Day, Good Friday, Easter Monday, Anzac Day, Queen’s Birthday, Christmas Day, Boxing Day, and other NSW state-specific holidays
Requests for these dates will return a 404 Not Found error.

​
Plan-Specific Access

  • Free Plan: No historical data access
  • Starter Plan: Last 30 days of historical data
  • Professional & Business Plans: Full historical archive (2018 onwards)

​
Use Cases

  • Invoice Calculations: Get official RBA rates for specific transaction dates
  • Compliance Reporting: ATO reporting with exact historical rates
  • Audit Requirements: Verify exchange rates used in past transactions
  • Financial Analysis: Compare rates from specific dates
  • Accounting Integration: Import historical rates for month-end/quarter-end processing
  • Regulatory Compliance: Meet Australian financial reporting standards

​
Precision & Standards

  • Precision: Rates provided with up to 6 decimal places (varies by currency)
  • Currency-specific precision: IDR and VND are provided as whole numbers by the RBA source data
  • Source: Official Reserve Bank of Australia daily rates
  • Rounding: Rates are stored as micro-units (rate × 1e6) and converted for display where applicable
  • Standards: Complies with Australian financial reporting requirements

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token

Path Parameters

​
date
string
required

Date in YYYY-MM-DD format

Response

Exchange rates for the specified date

​
success
boolean
required
Example:

true

​
timestamp
integer
required

Unix timestamp of the rate date

​
base
string
required
Example:

"AUD"

​
date
string
required

Date of the rates (YYYY-MM-DD)

​
rates
object
required

Object containing currency codes as keys and exchange rates as values