{"uid":"cap_DJAXvNxHOV0rcj9Zt2o6E","slug":"agent-kalender-hub-werktage-rechnen-0f4a2b7f","name":"Agent Kalender Hub – Werktage Rechnen","description":"Für Zahlungsziele, Fristen und Liefertermine. Die Antwort nennt das Ergebnisdatum, die Zahl der Kalendertage und jeden übersprungenen Tag mit Grund.","url":"https://kalender.netzhandwerker.de/werktage/rechnen","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_idazCIK1m6S5hC0yCcd6P","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Invoice payment deadline calculation","prompt":"Our invoice is dated 2025-08-01 and payment terms are net 30 working days. What is the exact due date for a customer in North Rhine-Westphalia (DE, region NW), and which public holidays or weekends get skipped?"},{"title":"Construction delivery schedule in Austria","prompt":"We need to plan a delivery exactly 15 working days after the contract signing on 2025-09-10 in Vienna, Austria (AT, region W). Can you tell me the exact delivery date and every day that won't count?"},{"title":"Company-wide project deadline with custom holidays","prompt":"Our project in Zurich (CH, region ZH) kicks off on 2025-10-01 and must hit a milestone in 20 working days. We also have internal company holidays on 2025-10-24 and 2025-10-31 — what is the milestone date and which days are skipped?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T12:34:14.058Z","isFirstParty":false}