{"uid":"cap_cEoaHhQ1r0mO19amdAUYk","slug":"public-holidays-by-country-and-year-074c6bc7","name":"Public Holidays by Country and Year","description":"Public holidays for 100+ countries for any year — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/geo/public-holidays?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"year":{"type":"integer","maximum":2100,"minimum":1975,"description":"optional, default this year"},"country":{"type":"string","description":"required ISO-2, e.g. US, GB, DE"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"public-holidays","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.001,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"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_WIuHfQqs1oDk5gxqUZMjV","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 the list of public holidays for a given country (ISO-2 code) and optional year, covering 100+ countries.","exampleAgentPrompt":"What are all the public holidays in Germany for 2025?","exampleUseCases":[{"title":"HR payroll calendar automation","prompt":"Pull all public holidays in the United States for 2025 so I can mark the non-working days in our payroll system."},{"title":"Travel itinerary planning","prompt":"What are the official public holidays in Japan for 2026? I want to know which days might be busy or have closures when I visit."},{"title":"Cross-border meeting scheduling","prompt":"List the public holidays in France for this year — I need to avoid scheduling client calls on days when the Paris office will be closed."}],"resultDescription":"A structured list of public holidays for the requested country and year, including holiday names and their calendar dates.","failureModes":["Missing or invalid ISO-2 country code returns an error","Country not in the 100+ supported list may return empty or error","Year outside the 1975–2100 range is rejected by schema validation","Network or payment authorization failure returns a 402 or connectivity error"],"whenToPreferThis":"Choose this endpoint when you need a reliable, structured list of official public holidays for a specific country and year, especially for scheduling, HR, payroll, or travel planning workflows. It covers 100+ countries and historical years back to 1975, making it suitable for both forward-looking planning and retrospective analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:48:08.756Z","isFirstParty":false,"canonicalSlug":"public-holidays-by-country-and-year-074c6bc7"}