Historical Rate for Currency and Date (/{date}/{currency})

GET

{date}

{currency}

Historical Rate for Currency and Date

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

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

fetch('https://api.exchangeratesapi.com.au/{date}/{currency}', 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}/{currency}",
  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}/{currency}"

	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}/{currency}")

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

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

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.Examples: 2025-08-31, 2024-12-31, 2023-06-15

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"

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

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

import requests

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

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

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

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.exchangeratesapi.com.au/{$date}/{$currency}",
  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
  }
}

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

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": 400,
    "type": "bad_request",
    "info": "Invalid currency format. Use 3-letter currency code (e.g., USD)"
  }
}

{
  "success": false,
  "error": {
    "code": 404,
    "type": "not_found",
    "info": "No USD rate available for date 2025-08-31. 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 2025-12-25"
  }
}

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

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

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

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)

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

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

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

fetch('https://api.exchangeratesapi.com.au/{date}/{currency}', 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}/{currency}",
  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}/{currency}"

	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}/{currency}")

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

Public Endpoints

Authenticated Endpoints

Webhooks

API Reference

Historical Rate for Currency and Date (/{date}/{currency})

Overview

Authentication

Path Parameters

Request

Response

Response Fields

Response Headers

Error Responses

Rate Limits

Historical Data Availability

Date Range

Missing Dates

Plan-Specific Access

Currency Availability

Use Cases

Best Practices

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

​Currency Availability

​Use Cases

​Best Practices

​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

Currency Availability

Use Cases

Best Practices

Precision & Standards