{"uid":"cap_Wh0yL9gb11pQEchNS26b4","slug":"agent-data-tools-revmesh2074-workers-dev-public-holidays-by-country-e53fbdc7","name":"Public Holidays by Country and Year","description":"Public holidays for a country and year: date, local and English name, whether it is nationwide and the observed day, for over 100 countries. Use to plan deliveries, schedules and business days, or to tell whether today is a holiday somewhere.","url":"https://agent-data-tools.revmesh2074.workers.dev/holidays/public?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["country"],"properties":{"year":{"type":"integer","description":"Year, 2024-2100 (default this year)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code (US, GB, SE, JP, CA…) or English country name"}}},"responseSchema":{"type":"object","properties":{"note":{"type":"string"},"year":{"type":"number"},"count":{"type":"number"},"country":{"type":"string"},"holidays":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"name":{"type":"string"},"types":{"type":"array","items":{"type":"string"}},"observed":{},"localName":{"type":"string"},"nationwide":{"type":"boolean"}}}},"countryName":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MBFJih50_zfaY1URpAvSW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Returns all public holidays for a given country and year, including date, local and English name, nationwide flag, and observed day.","exampleAgentPrompt":"Can you list all the public holidays in Japan for 2025, including their local names and whether each one is nationwide?","exampleUseCases":[{"title":"Logistics delivery blackout dates","prompt":"List all public holidays in Germany for 2025 so I can block out those dates and avoid scheduling deliveries on days when nothing will be open."},{"title":"Check if today is a holiday abroad","prompt":"Is today a public holiday in Brazil? I need to know before trying to reach our São Paulo office."},{"title":"Cross-country meeting scheduler","prompt":"What public holidays does Canada have in October 2025? I want to avoid booking team calls on those days."}],"resultDescription":"A JSON object containing the country name, year, total holiday count, and an array of holiday objects — each with the ISO date, English name, local name, observed date (if different), a boolean for whether it is nationwide, and an array of type tags (e.g. public, bank, optional).","failureModes":["Invalid or unrecognized country code returns an error or empty holidays array","Year outside supported range (2024-2100) may return an error or no results","Country with no data coverage returns empty holidays list","Misspelled country name may fail to match — prefer ISO alpha-2 codes","Missing required 'country' parameter returns a 400-level error"],"whenToPreferThis":"Use this endpoint when you need machine-readable public holiday data for any of 100+ countries, especially for scheduling, logistics, or business-day calculations. It supports future years up to 2100, returns observed dates alongside official dates, and flags whether each holiday is nationwide — making it more useful than a simple calendar lookup when regional or observed-day accuracy matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T09:36:18.669Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-public-holidays-by-country-e53fbdc7"}