Public Holidays · Data API

Australian Public Holidays

A comprehensive list of public holidays for all Australian states and territories.

Provides the date, name, and jurisdiction for every public holiday in Australia. Crucial for logistics and delivery scheduling, payroll systems, and retail platforms planning for sales and staffing.

Get API key View docs

Source: data.gov.au · CC BY 4.0 · Department of the Prime Minister and Cabinet

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

GET /v1/data/australian-public-holidays
GET /v1/data/australian-public-holidays/search?q=...
GET /v1/data/australian-public-holidays/{key}

Base path /v1/data/australian-public-holidays · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

Field	Type	Description
holiday_date	date	The date of the public holiday in YYYY-MM-DD format.
holiday_name	str	The official name of the public holiday.
jurisdiction	str	The state or territory abbreviation (e.g., NSW, VIC, QLD).

What you get

Covers all Australian states and territories.

Simple, clean data with just the essential fields.

Official data sourced from federal and state governments.

Stable dataset perfect for applications needing future dates.

Standard CSV format for easy parsing.

FAQ

Does this include local or regional holidays?: It primarily includes state and national holidays. Some major regional holidays (e.g., Melbourne Cup) are included, but very localised show holidays may not be.
How far into the future does the data go?: The current file covers up to the end of 2025. Government sources are used to update future years as they are announced.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day

100 API requests per day
All endpoints included
Community support

Get Started

Pro

$9/month

For production apps and AI agents

10,000 requests/day

10,000 API requests per day
All endpoints included
Priority support
Usage dashboard

Upgrade to Pro

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests

Unlimited API requests
All endpoints included
Priority support
Usage dashboard
Dedicated support channel

Go Enterprise

Getting Started

Start building in minutes

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"