Historical Rates for Date (/{date})

GET

{date}

Historical Rates for Date

curl --request GET \
  --url https://api.exchangeratesapi.com.au/{date} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.exchangeratesapi.com.au/{date}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.exchangeratesapi.com.au/{date}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.exchangeratesapi.com.au/{date}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.exchangeratesapi.com.au/{date}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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

string

required

Bearer token with your API key: Bearer your_api_key_here

Path Parameters

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"

const date = '2025-08-31';
const response = await fetch(`https://api.exchangeratesapi.com.au/${date}`, {
  headers: {
    'Authorization': 'Bearer your_api_key_here'
  }
});

const data = await response.json();
console.log(data);

import requests

date = "2025-08-31"
url = f"https://api.exchangeratesapi.com.au/{date}"
headers = {
    "Authorization": "Bearer your_api_key_here"
}

response = requests.get(url, headers=headers)
data = response.json()
print(data)

<?php
$date = '2025-08-31';
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.exchangeratesapi.com.au/{$date}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer your_api_key_here'
  ),
));

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
print_r($data);
?>

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

boolean

Indicates if the request was successful

integer

Unix timestamp for the specified date (midnight UTC)

string

Base currency (always “AUD”)

string

The requested date in YYYY-MM-DD format

object

Object containing all available currency codes and their exchange rates for the specified date

Show rates object

number

Exchange rate (AUD per unit of foreign currency) with precision varying by currency (up to 6 decimal places for most, whole numbers for IDR/VND as provided by RBA)

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"
  }
}

{
  "success": false,
  "error": {
    "code": 404,
    "type": "not_found",
    "info": "No data available for date 2025-12-25. RBA data may not be available for this date. Try /latest for current rates."
  }
}

{
  "success": false,
  "error": {
    "code": 404,
    "type": "not_found",
    "info": "No data available for date 2017-12-31"
  }
}

{
  "success": false,
  "error": {
    "code": 401,
    "type": "unauthorized",
    "info": "Invalid or missing API key"
  }
}

Rate Limits

This endpoint is subject to your plan’s monthly request limits:

Plan	Monthly Requests	Historical Access
Free	300	No historical data
Starter	5,000	Last 30 days
Professional	50,000	Full history (2018+)
Business	500,000	Full 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

Pattern: ^\d{4}-\d{2}-\d{2}$

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)

Pattern: ^\d{4}-\d{2}-\d{2}$

rates

object

required

Object containing currency codes as keys and exchange rates as values

Show child attributes

Historical Rate for Currency and Date (/{date}/{currency})Get the exchange rate for a specific currency on a specific historical date

Historical Rates for Date

curl --request GET \
  --url https://api.exchangeratesapi.com.au/{date} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.exchangeratesapi.com.au/{date}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.exchangeratesapi.com.au/{date}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.exchangeratesapi.com.au/{date}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.exchangeratesapi.com.au/{date}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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
  }
}

Public Endpoints

Authenticated Endpoints

Webhooks

API Reference

Historical Rates for Date (/{date})

Overview

Authentication

Path Parameters

Request

Response

Response Fields

Response Headers

Error Responses

Rate Limits

Historical Data Availability

Date Range

Missing Dates

Plan-Specific Access

Use Cases

Precision & Standards

Authorizations

Path Parameters

Response

​Overview

​Authentication

​Path Parameters

​Request

​Response

​Response Fields

​Response Headers

​Error Responses

​Rate Limits

​Historical Data Availability

​Date Range

​Missing Dates

​Plan-Specific Access

​Use Cases

​Precision & Standards

Authorizations

Path Parameters

Response

Overview

Authentication

Path Parameters

Request

Response

Response Fields

Response Headers

Error Responses

Rate Limits

Historical Data Availability

Date Range

Missing Dates

Plan-Specific Access

Use Cases

Precision & Standards