# Ausref Public Holidays by Country

> Ausref Public Holidays by Country is a paid API for AI agents from ausref.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-23).

Returns gazette-cited public holidays for an Australasian/Oceania country, with date, name, source URL, and last-confirmed timestamp, optionally filtered by year.

## Facts

- Endpoint: GET https://ausref.dev/v1/holidays/:country?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ausref-public-holidays-by-country-36684f0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MOGXmk5eUQU47qADDVVzJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ausref-public-holidays-by-country-36684f0d
```

Example prompt: Can you pull up all official public holidays in Australia for 2025, with their gazette sources?

## When to prefer this

Choose this endpoint when you need authoritative, gazette-cited public holiday data specifically for Australasian or Oceania countries (AU, NZ, FJ, etc.) and require traceability to the official government source. Prefer it over generic global holiday APIs when source citation and last-confirmed freshness metadata are important, such as for compliance, payroll, or legal applications.

## Known failure modes

- Unsupported country code returns 404 or empty array
- Invalid year format returns a 400 bad request
- Stale data if the government source has not been recrawled recently
- Country codes outside Oceania/Australasia may not be supported

## How this service works

Australasian public holidays by country, cited to the official gazette or government source: date, name, source URL, last_confirmed. ?year=YYYY to filter. GET /v1/holidays/{country}, e.g. /v1/holidays/au.

## Output

A JSON array of public holiday records for the requested country, each containing the holiday date, official name, a URL to the gazette or government source, and a last_confirmed field indicating when the record was last verified. Optionally filtered to a single calendar year when the ?year=YYYY query parameter is supplied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ausref-public-holidays-by-country-36684f0d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ausref.dev](https://www.zero.xyz/host/ausref.dev/llms.txt)