{"uid":"cap_GHoAQnItJD1XyWlbjU0Kq","slug":"agent-kalender-hub-werktage-rechnen-0b96d0f0","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.halowerk.com/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_rtXYhgM0z_Vc9iBN3CCKW","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, accounting for public holidays in Germany, Austria, and Switzerland (including regional/cantonal variants) and optional custom days off.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Invoice payment deadline calculation","prompt":"Our invoice goes out today, 2025-06-01, and our contract says payment is due within 30 working days under German law, Bayern region. What's the exact due date, and can you tell me which days get skipped and why — including our Betriebsferien on 2025-06-20?"},{"title":"Supplier delivery deadline in Switzerland","prompt":"I need to tell our Zurich supplier (canton ZH) that they have 15 working days from 2025-07-10 to deliver. What's the final delivery deadline date, and which days are skipped along the way?"},{"title":"Legal filing deadline backward from court date","prompt":"We have a court hearing in Austria, Vienna, on 2025-09-15, and we need to file documents exactly 20 working days before that. Count backward 20 working days from that date and tell me the filing deadline, listing any skipped public holidays."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:32:06.171Z","isFirstParty":false}