# Agent Kalender Hub – Werktage Rechnen

> Agent Kalender Hub – Werktage Rechnen 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-16).

Calculates a target date by counting a given number of working days forward or backward from a start date, accounting for public holidays in Germany, Austria, and Switzerland (including regional/cantonal variants) and optional custom days off.

## Facts

- Endpoint: POST https://kalender.halowerk.com/werktage/rechnen
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-kalender-hub-werktage-rechnen-0b96d0f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GHoAQnItJD1XyWlbjU0Kq

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-rechnen-0b96d0f0 -d '<json body>'
```

Example prompt: Calculate the payment due date for an invoice issued today (2025-06-01) with a 30-working-day target in Germany, Bavaria region — and list every skipped day with its reason, including our company holiday on 2025-06-20.

## When to prefer this

Choose this endpoint when you need precise working-day arithmetic for legal, financial, or logistical deadlines in Germany (including all 16 states and the Augsburg municipal special case), Austria (all 9 states), or Switzerland (all cantons) — especially when accurate regional public holiday exclusion is critical and you need a full audit trail of every skipped day with its reason. Prefer this over generic date libraries when regional holiday granularity, company-specific additional days off, or backward counting to a known deadline are required.

## Known failure modes

- Invalid date format (non-YYYY-MM-DD) returns a 400 error
- Invalid country code or region/canton code not matching the selected country returns an error
- werktage value outside the -2000 to 2000 range is rejected
- zusatzfrei array exceeding 100 items is rejected
- Missing required fields (start, werktage) result in validation errors
- Payment not included or insufficient results in HTTP 402 Payment Required

## How this service works

Für Zahlungsziele, Fristen und Liefertermine. Die Antwort nennt das Ergebnisdatum, die Zahl der Kalendertage und jeden übersprungenen Tag mit Grund.

## Output

Returns the calculated result date, the total number of calendar days spanned, and a detailed list of every day that was skipped during counting — each annotated with its reason (weekend, specific named public holiday, or custom/company day off provided by the caller).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "land": {
   "enum": [
    "DE",
    "AT",
    "CH"
   ],
   "type": "string",
   "default": "DE",
   "description": "Country code."
  },
  "start": {
   "type": "string",
   "format": "date",
   "description": "Start date, format YYYY-MM-DD. It is never counted itself."
  },
  "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."
  },
  "werktage": {
   "type": "integer",
   "maximum": 2000,
   "minimum": -2000,
   "description": "Positive counts forward, negative backward, 0 returns the next working day on or after the start date."
  },
  "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-rechnen-0b96d0f0/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)