{"uid":"cap__AtsqJ3pkoltwRc9qc1WB","slug":"german-federal-state-public-holidays-api-ad1f2ef2","name":"German Federal State Public Holidays API","description":"Returns the public holidays (bank holidays, Feiertage) of a German federal state for one year, each with date, weekday and the citation in that state's own act. Public holidays in Germany are state law; only 3 October is federal. Regionally limited ones (Assumption Day in Bavaria, Corpus Christi in Saxony and Thuringia) are flagged and do NOT apply statewide. All 16 state lists read against the statute, each with source and check date.","url":"https://api.ozdreamtools.de/api/holidays","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"year":{"type":"integer","description":"Calendar year, 1583 to 2200 (validity range of the Gregorian Easter formula)."},"state":{"type":"string","description":"Federal state code: BW BY BE BB HB HH HE MV NI NW RP SL SN ST SH TH"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wbMGy4bCe7sM6W-bgthyF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the official public holidays (Feiertage) for a specified German federal state and year, with dates, weekdays, statutory citations, and regional applicability flags","exampleAgentPrompt":"Can you get me the full list of public holidays in Bavaria for 2025, including which ones are only regionally valid and the statute they come from?","exampleUseCases":[{"title":"Payroll calendar setup for German employees","prompt":"I need the complete list of public holidays for North Rhine-Westphalia in 2025 — with exact dates and the legal source — so I can configure our payroll system's holiday calendar."},{"title":"Cross-state HR compliance check","prompt":"We have staff in both Bavaria and Saxony — can you pull the official Feiertage for both states in 2024 and flag which ones are regionally limited rather than applying to the whole state?"},{"title":"Deadline calculation around German holidays","prompt":"I need to know all public holidays in Berlin for 2025, including their weekdays and statutory references, so I can avoid scheduling legal deadlines on non-working days."}],"resultDescription":"A structured list of public holidays for the requested German federal state and year, each entry containing the holiday name, date, weekday, the specific clause of the state act authorizing it, and a flag indicating whether the holiday is limited to a region within the state (rather than applying statewide)","failureModes":["Invalid or unrecognized state code returns an error","Year out of supported range returns an error","Missing required parameters (state or year) returns a validation error","Network timeout on the POST request"],"whenToPreferThis":"Use this endpoint when you need authoritative, statute-cited German public holiday data for a specific federal state, especially when you need to know whether a holiday applies statewide or only regionally (e.g. Assumption Day in Bavaria, Corpus Christi in Saxony). Prefer this over generic calendar APIs when legal accuracy and statutory references matter, such as for payroll, HR systems, legal deadline calculation, or compliance tooling in Germany.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:54.577Z","isFirstParty":false}