# Agent Kalender Hub – Public Holiday Lookup (DE/AT/CH)

> Agent Kalender Hub – Public Holiday Lookup (DE/AT/CH) is a paid API for AI agents from kalender.netzhandwerker.de, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns official public holidays for Germany (by state and municipal exceptions), Austria (by state), and Switzerland (by canton) for a given year, with moveable feasts calculated from the Easter date.

## Facts

- Endpoint: POST https://kalender.netzhandwerker.de/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-holiday-lookup-de-at-ch-69bcae3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uvyIx5hoFNBWc6BSk7-Gt

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-holiday-lookup-de-at-ch-69bcae3e -d '<json body>'
```

Example prompt: Can you list all the public holidays in Bavaria (BY) for 2025, including moveable feasts?

## When to prefer this

Use this endpoint when you need authoritative, region-specific public holiday data for Germany, Austria, or Switzerland, especially when you need moveable feasts calculated precisely (not from a static table). Prefer this over generic calendar APIs when you need German municipal exceptions (like Augsburg's Peace Festival) or Swiss cantonal granularity.

## Known failure modes

- Invalid country code returns an error or empty result
- Invalid or unsupported region code for the given country may return only nationwide holidays or an error
- Year outside the supported range (1970–2200) is rejected
- Missing required fields may fall back to defaults (current year, DE)
- Network timeout or service unavailability returns no data

## 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 specified country, state/canton, and year. Each entry typically includes the holiday date and name. Moveable feasts (such as Easter Monday, Whit Monday, Corpus Christi) are computed algorithmically from the Easter date rather than from a static table. Without a region code, only nationwide holidays are returned; with a region, state-level or cantonal holidays are added. Germany also supports a municipal-level code (e.g. 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-holiday-lookup-de-at-ch-69bcae3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kalender.netzhandwerker.de](https://www.zero.xyz/host/kalender.netzhandwerker.de/llms.txt)