API reference

Calendars

Industry calendars for every jurisdiction: RDOs, public holidays, school holidays and shutdowns, verified against the official lists, and the answer to whether a date is a working day. Base URL https://dataquoll.io/api/v1.

GET/calendars

Industry calendar editions

Every industry-calendar edition on the platform, one per jurisdiction and year (NSW, VIC, QLD, WA, SA, TAS, ACT and NT for 2026), with its publisher, cover range and per-category counts. RDOs, public holidays, school holidays and industry shutdowns, read from each branch calendar and verified against the Fair Work Ombudsman list and the education departments' term dates.

Responses

StatusDescription
200The editions
Request
curl "https://dataquoll.io/api/v1/calendars" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/calendars/{jurisdiction}

Calendar days for a jurisdiction

The day rows for one jurisdiction across a date range, each date answered by exactly one edition. Defaults to the current calendar year in the jurisdiction's own time zone; a lone from or to extends to the edge of its own year. Every place the calendar disagrees with the official list is returned under discrepancies. Rows can be CSV with format=csv.

Parameters

NameInRequiredTypeDescription
jurisdictionpathYesstringJurisdiction code
fromqueryNostringFirst date, YYYY-MM-DD
toqueryNostringLast date, YYYY-MM-DD
categoryqueryNostringComma-separated categories to include (default all). Values are the CalendarDay category enum.
formatqueryNostringjson (default) or csv

Responses

StatusDescription
200The days in range
400Unknown jurisdiction, malformed date, unknown category, or from after to
Request
curl "https://dataquoll.io/api/v1/calendars/{jurisdiction}" \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/calendars/{jurisdiction}/{date}

Is this a working day

The answer for one date in one jurisdiction. A jurisdiction-wide public holiday wins, then the weekend, then the calendar's own entries in order (industry shutdown, RDO, part-day holiday, annual leave, industry event); otherwise working. Restricted holidays (a show day for one region, a public-service-only day) never decide it and are returned under restricted for the caller to apply to the employer's area.

Parameters

NameInRequiredTypeDescription
jurisdictionpathYesstringJurisdiction code
datepathYesstringThe date, YYYY-MM-DD

Responses

StatusDescription
200The verdict
400Unknown jurisdiction or malformed date
404No edition covers the date; the detail names the editions that exist
Request
curl "https://dataquoll.io/api/v1/calendars/{jurisdiction}/{date}" \
  -H "Authorization: Bearer YOUR_API_KEY"