# Agent Kalender Hub – Werktage Rechnen

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

Calculates a target date by counting a given number of working days forward or backward from a start date, skipping weekends, public holidays (regional-aware for DE/AT/CH), and custom company days off.

## Facts

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

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

Example prompt: What date falls exactly 30 working days from today (2025-07-14) in Bavaria (DE, region BY), counting Saturdays as normal working days — and list every day that gets skipped with the reason?

## When to prefer this

Choose this endpoint when you need region-aware working-day arithmetic for Germany (including municipality-level exceptions like Augsburg), Austria, or Switzerland — especially when you need the full audit trail of skipped days with named reasons. Prefer this over generic date-math libraries when statutory public holidays at state/canton level must be respected, or when custom company holidays need to be layered on top.

## Known failure modes

- Invalid or missing start date returns a 400 error
- werktage value outside [-2000, 2000] range is rejected
- Unsupported region code for the selected country returns an error
- zusatzfrei items with malformed date strings are rejected
- Exceeding 100 custom days off (zusatzfrei) returns a validation error
- Payment failure (x402) if USDC balance is insufficient

## 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 computed result date (YYYY-MM-DD), the total number of calendar days spanned, and a detailed list of every skipped day with its reason (weekend, named public holiday, or custom day off). Public holiday names are returned in the local language.

## 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-0f4a2b7f/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)