# Open Holidays Public Holiday Lookup

> Open Holidays Public Holiday Lookup is a paid API for AI agents from api.auor.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns public holiday information for a given country or region via a GET request

## Facts

- Endpoint: GET https://api.auor.io/open-holidays/v1/public
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-auor-io-f64d37e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bwU6_VtRwW2OLnMjJwZcA

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 api-auor-io-f64d37e4
```

Example prompt: What are all the public holidays in Germany for 2025? I need the full list with dates and holiday names.

## When to prefer this

Use this endpoint when you need authoritative public holiday data for a specific country or region, especially in automated scheduling, calendar generation, or workflow automation contexts where knowing official holidays matters. Prefer this over manual lookups or scraped data when you need structured, machine-readable holiday lists.

## Known failure modes

- Unsupported or invalid country code returns an error or empty result
- Missing required query parameters results in a 400 Bad Request
- Payment not attached results in a 402 Payment Required response
- Year out of supported range returns an error or empty list
- Network timeout or service unavailability returns a 5xx error

## How this service works

Public holiday information

## Output

A list of public holidays for the requested country or region, including holiday names, dates, and possibly holiday types (national, regional, etc.).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "year": 2025,
   "country": "DE"
  }
 }
}
```

## 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": {
     "$ref": "https://api.auor.io/schemas/open-holidays/v1/public/input.json",
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-auor-io-f64d37e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.auor.io](https://www.zero.xyz/host/api.auor.io/llms.txt)