Skip to main content
GET
/
{date}
/
{currency}
Historical Rate for Currency and Date
curl --request GET \
  --url https://api.exchangeratesapi.com.au/{date}/{currency} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "timestamp": 1725062400,
  "base": "AUD",
  "date": "2025-08-31",
  "rates": {
    "USD": 0.643512
  }
}

​
Overview

The historical date-currency endpoint returns the exchange rate for a single currency on a specific historical date. This is the most precise endpoint when you need a specific rate for exact calculations, invoice processing, or compliance reporting.
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.Examples: 2025-08-31, 2024-12-31, 2023-06-15
​
currency
string
required
Three-letter currency code (case-insensitive). Must be one of the supported currencies.Examples: USD, EUR, GBP, JPY, NZD

​
Request

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

​
Response

{
  "success": true,
  "timestamp": 1725062400,
  "base": "AUD",
  "date": "2025-08-31",
  "rates": {
    "USD": 0.643512
  }
}

​
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 the requested currency code and its exchange rate

​
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)

​
Currency Availability

Not all currencies may be available for every historical date. The RBA occasionally:
  • Adds new currencies to their daily publication
  • Removes currencies that are no longer actively tracked
  • Skips currencies on certain dates due to market conditions
If a specific currency rate is not available for the requested date, you’ll receive a 404 error with details.

​
Use Cases

  • Precise Invoice Calculations: Get the exact rate for a specific transaction date and currency
  • Audit Trail: Verify specific rates used in historical transactions
  • Compliance Verification: ATO reporting with exact RBA rates
  • Contract Settlements: Apply correct rates for dated financial agreements
  • Accounting Reconciliation: Match rates to specific accounting periods
  • Regulatory Documentation: Support compliance with exact rate citations

​
Best Practices

  • Error Handling: Always check for 404 responses, especially for weekend dates or holidays
  • Currency Validation: Verify currency codes against the supported currencies list
  • Date Validation: Ensure dates are in correct format and within available range
  • Caching: Cache responses locally as historical rates don’t change
  • Batch Requests: For multiple currencies on the same date, consider using the historical date endpoint

​
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 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

​
currency
enum<string>
required

Currency code Three-letter currency code

Available options:
AUD,
USD,
EUR,
GBP,
JPY,
CNY,
KRW,
INR,
SGD,
NZD,
THB,
MYR,
IDR,
VND,
HKD,
PHP,
CAD,
CHF,
TWD,
TWI,
SDR

Response

Exchange rate for the specified currency and 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