# Netzhandwerker Workdays Calendar API

> Netzhandwerker Workdays Calendar API is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Checks whether a given date is a working day in a German federal state and optionally adds a number of working days to a date

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/calendar/workdays
- 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/netzhandwerker-workdays-calendar-api-badec2da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9KRn2izhzyhtBIDuP_upT

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 netzhandwerker-workdays-calendar-api-badec2da -d '<json body>'
```

Example prompt: Is next Monday a working day in North Rhine-Westphalia (NW), and if so what date falls 5 working days after it?

## When to prefer this

Choose this endpoint when you need to compute business-day-aware dates specifically for German federal states, where regional public holiday differences matter (e.g. Bavaria vs. North Rhine-Westphalia have different holidays). Prefer this over generic calendar APIs when German regional compliance is required for scheduling, deadlines, SLAs, or payment terms.

## Known failure modes

- Invalid or unsupported region code returns an error — must use valid German Bundesland abbreviations like NW, BY, SN
- Malformed ISO date string causes a parse error
- Missing required fields (date or region) result in a 400-level error
- Unsupported country may not have holiday data available
- Out-of-range year may lack holiday schedule data

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns whether the specified date is a working day in the given German federal state, and if add_workdays is provided, returns the resulting date after adding that number of working days, accounting for regional public holidays and weekends.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string"
  },
  "date": {
   "type": "string",
   "description": "ISO-Datum für Werktagsprüfung"
  },
  "from": {
   "type": "string"
  },
  "year": {
   "type": "integer"
  },
  "region": {
   "type": "string",
   "description": "Bundeslandkürzel, z. B. NW, BY, SN"
  },
  "country": {
   "enum": [
    "DE",
    "AT",
    "CH"
   ],
   "type": "string",
   "default": "DE"
  },
  "timezone": {
   "type": "string",
   "default": "Europe/Berlin"
  },
  "add_workdays": {
   "type": "integer",
   "description": "Werktage auf date addieren"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2026,
  "region": "NW",
  "country": "DE",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "Neujahr"
   }
  ],
  "timezone": {
   "dst": true,
   "name": "Europe/Berlin",
   "utc_offset": "+02:00"
  },
  "date_info": {
   "date": "2026-08-06",
   "holiday": null,
   "weekday": "Donnerstag",
   "workday": true
  },
  "add_workdays_result": "2026-08-20"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-workdays-calendar-api-badec2da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.netzhandwerker.de](https://www.zero.xyz/host/tools.netzhandwerker.de/llms.txt)