# Agent Kalender Hub – Werktage (Working Days Calculator)

> Agent Kalender Hub – Werktage (Working Days Calculator) 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-15).

Calculates the number of working days in a date range for Germany, Austria, and Switzerland, accounting for weekends, public holidays (national and regional), and custom days off.

## Facts

- Endpoint: POST https://kalender.halowerk.com/werktage
- 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/agent-kalender-hub-werktage-working-days-calculator-0575cb4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Nhl6K_x9DExqe8JQZ3V_0

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-werktage-working-days-calculator-0575cb4f -d '<json body>'
```

Example prompt: How many working days are there between March 1 and March 31, 2026 in Bavaria (DE, BY), treating Saturdays as regular workdays and excluding our company holiday on March 15?

## When to prefer this

Use this endpoint when you need accurate working-day counts for the DACH region (Germany, Austria, Switzerland) with full public holiday coverage at the national and regional/state/canton level, including support for custom company holidays and configurable Saturday/Sunday treatment. Prefer this over generic business-day libraries when regional German-speaking holiday rules are required.

## Known failure modes

- Invalid date format (not YYYY-MM-DD) returns a 400 error
- Unsupported or misspelled region code causes incorrect or no holiday exclusions
- Date range where 'von' is after 'bis' may return zero or an error
- More than 100 custom days off (zusatzfrei) exceeds the maxItems limit
- Unsupported country code outside DE/AT/CH returns a validation error
- Payment failure via x402 protocol results in 402 response and no computation

## How this service works

Jeder übersprungene Tag kommt mit Grund zurück: Wochenende, benannter Feiertag oder ein selbst gesetzter freier Tag. Samstag und Sonntag lassen sich zu Werktagen erklären.

## Output

Returns the count of working days in the specified date range after subtracting weekends (unless overridden), statutory public holidays for the given country and region, and any custom days off provided. May also include details on which days were skipped and the reasons (weekend, named holiday, or custom day off).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bis": {
   "type": "string",
   "format": "date",
   "description": "Last day of the range, inclusive."
  },
  "von": {
   "type": "string",
   "format": "date",
   "description": "First day of the range, inclusive, format YYYY-MM-DD."
  },
  "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."
  },
  "zusatzfrei": {
   "type": "array",
   "items": {
    "type": [
     "string",
     "object"
    ]
   },
   "maxItems": 100,
   "description": "Own days off on top of the statutory ones, for example company holidays. Either \"2026-05-15\" or {\"datum\":\"2026-05-15\",\"grund\":\"Betriebsferien\"}."
  },
  "samstag_ist_werktag": {
   "type": "boolean",
   "default": false,
   "description": "Count Saturdays as working days."
  },
  "sonntag_ist_werktag": {
   "type": "boolean",
   "default": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-kalender-hub-werktage-working-days-calculator-0575cb4f/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)