{"uid":"cap_6Zo8E4X8hOpBbi3pYUNLt","slug":"sitecheck-public-holidays-lookup-a535b1d7","name":"SiteCheck Public Holidays Lookup","description":"Public holidays of a country (ISO 2 code) for a year (default: this year): date, local and English names, and whether the holiday is nationwide or regional with its counties. Source: Nager.Date. An empty list is a valid answer.","url":"https://api.sitecheck-api.workers.dev/api/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"year":{"type":"string","description":"1900 to 2100 (default: this year)"},"country":{"type":"string","description":"ISO 3166 alpha-2 code, e.g. DE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"count":19,"source":"Nager.Date public holidays API (https://date.nager.at)","country":"DE","holidays":[{"date":"2026-01-01","name":"New Year's Day","counties":null,"localName":"Neujahr","nationwide":true},{"date":"2026-01-06","name":"Epiphany","counties":["DE-BW","DE-BY"],"localName":"Heilige Drei Könige","nationwide":false}],"checkedAt":"2026-10-14T04:49:24.327Z"}},"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_7-PmOYAVLCaMEMW0nf5Wr","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":"Returns a list of public holidays for a given country and year using ISO 3166 alpha-2 country codes.","exampleAgentPrompt":"What are all the public holidays in Germany for 2026?","exampleUseCases":[{"title":"Scheduling around national holidays","prompt":"Can you get me all the public holidays in France for 2025 so I can avoid scheduling meetings on those days?"},{"title":"Regional holiday awareness for Bavaria","prompt":"List the public holidays in Germany for 2024 — I need to see which ones apply only to Bavaria versus the whole country."},{"title":"HR payroll calendar planning","prompt":"What public holidays are there in the United Kingdom in 2026? I need the full list with dates and names for our payroll calendar."}],"resultDescription":"Returns a JSON object containing the year, country code, total holiday count, source attribution, and an array of holiday objects each with date, English name, local name, list of applicable county/region codes (null if nationwide), and a nationwide boolean flag. Also includes a checkedAt timestamp.","failureModes":["Missing or invalid country code returns an error — must be a valid ISO 3166 alpha-2 code","Year out of range (outside 1900–2100) may return an error or empty result","Country not supported by Nager.Date returns empty or error response","Network timeout from underlying Nager.Date API","Malformed query parameters return validation error"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable public holiday data for a specific country and year, particularly when you need regional/county-level granularity (e.g. which holidays apply only to specific German states). It is ideal for scheduling, payroll, compliance, or calendar automation workflows where you need to programmatically check holidays across countries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:42:27.134Z","isFirstParty":false,"canonicalSlug":"sitecheck-public-holidays-lookup-a535b1d7"}