# Agent Kalender Hub – Public Holidays

> Agent Kalender Hub – Public Holidays is a paid API for AI agents from kalender.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns public holidays for Germany (by state, including Augsburg special case), Austria (by state), or Switzerland (by canton) for a given year, computing moveable feasts from Easter rather than a static table.

## Facts

- Endpoint: POST https://kalender.halowerk.com/feiertage
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-kalender-hub-public-holidays-7bd921a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LImg9Nk9lYNoZJxb5zE9T

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 agent-kalender-hub-public-holidays-7bd921a7 -d '<json body>'
```

Example prompt: What are all the public holidays in Bavaria (BY) for 2025? I need the full list including regional ones.

## When to prefer this

Use this endpoint when you need authoritative, algorithmically computed public holidays for Germany (all 16 states plus Augsburg special case), Austria (all 9 states), or Switzerland (all cantons) — especially when scheduling, deadline calculation, or payroll processing depends on accurate regional holiday data. Prefer this over static calendar tables when moveable feasts (Easter-derived holidays) must be correct for any arbitrary year between 1970 and 2200.

## Known failure modes

- Invalid country code returns error or empty result
- Region code not matching the selected country causes no regional holidays to be returned
- Year outside 1970–2200 range is rejected by schema validation
- Missing required parameters may default to current year and DE
- Unknown canton or state abbreviation yields no regional holidays

## How this service works

Deutschland auf Bundeslandebene inklusive der Gemeinde-Sonderfälle, Österreich auf Bundeslandebene, die Schweiz auf Kantonsebene. Bewegliche Feste werden aus dem Osterdatum gerechnet, nicht aus einer Tabelle gelesen.

## Output

A list of public holidays for the requested country, region, and year, including holiday names and dates. Moveable feasts (e.g. Easter, Whit Monday) are calculated algorithmically from the Easter date rather than looked up from a static table. Without a region code, only nationwide holidays are returned. Germany supports state codes and the special municipal code BY-AU for Augsburg.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "jahr": {
   "type": "integer",
   "maximum": 2200,
   "minimum": 1970,
   "description": "Calendar year. Defaults to the current one."
  },
  "land": {
   "enum": [
    "DE",
    "AT",
    "CH"
   ],
   "type": "string",
   "default": "DE",
   "description": "Country code."
  },
  "region": {
   "type": "string",
   "description": "State code for DE (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH) and AT (B, K, N, O, S, ST, T, V, W), canton code for CH (AG, AI, AR, BE, BL, BS, FR, GE, GL, GR, JU, LU, NE, NW, OW, SG, SH, SO, SZ, TG, TI, UR, VD, VS, ZG, ZH). \"DE-BY\" works as well. Germany also knows the municipal code BY-AU for the city of Augsburg. Without a region only nationwide holidays are returned."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-kalender-hub-public-holidays-7bd921a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kalender.halowerk.com](https://www.zero.xyz/host/kalender.halowerk.com/llms.txt)