{"uid":"cap_J0q491p6HBZZku5ykV5mJ","slug":"tokenguard-public-holiday-lookup-864ae160","name":"tokenguard Public Holiday Lookup","description":"Which days are public holidays in this country? Full year of national and regional holidays with local names and a past/upcoming flag — date arithmetic an agent cannot infer from a calendar alone","url":"https://eltociear-tokenguard.hf.space/world/holidays","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"year":{"type":"integer","description":"Calendar year (defaults to the current one)"},"country":{"type":"string","description":"ISO 2-letter country code, e.g. JP"}}},"responseSchema":{"type":"json","example":{"year":2026,"count":16,"country":"JP","holidays":[{"date":"2026-01-01","name":"New Year's Day","past":true,"local_name":"元日","nationwide":true}]}},"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_Wx5Wg4JphHkiS1EtMh-lx","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 a full year of national and regional public holidays for a given country, including local names and a past/upcoming flag","exampleAgentPrompt":"Can you get me all the public holidays in Japan for 2025, including their local names and whether they've already passed or are still coming up?","exampleUseCases":[{"title":"Scheduling meetings across borders","prompt":"I'm planning a series of client calls with our office in Germany next quarter — can you pull all German public holidays for 2025 so I know which days to avoid?"},{"title":"Travel planning holiday awareness","prompt":"We're thinking of visiting South Korea in the fall of 2025. Can you get me a list of all their public holidays for that year so we can plan around any big national celebrations?"},{"title":"Payroll and compliance calendar","prompt":"I need to build out our payroll calendar for Brazil in 2025, including all national and regional holidays with their official local names — can you fetch that for me?"}],"resultDescription":"A structured list of public holidays for the specified country and year, each entry containing the date, the holiday's local name, whether it is a national or regional holiday, and a flag indicating whether the holiday is in the past or upcoming relative to today.","failureModes":["Invalid or unsupported ISO country code returns an error or empty result","Year parameter out of supported range may return an error","Network or payment failure (x402 micropayment not processed) results in 402 or timeout","Some countries may have incomplete regional holiday coverage"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, structured list of holidays for a specific country and year, especially when you need local-language holiday names, regional holidays alongside national ones, and a past/upcoming classification that goes beyond what a static calendar library can provide. Ideal for scheduling, payroll, travel planning, or compliance use cases where accurate, up-to-date holiday data per country is essential.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:53:18.485Z","isFirstParty":false}