{"uid":"cap_B8_WaQ4D95nOFfLeue12z","slug":"public-holidays-by-country-year-b14cdb90","name":"Public Holidays by Country & Year","description":"Public holidays — Public holidays for a country & year.","url":"https://mcpfax-utility.bowling-anthony.workers.dev/v1/holidays","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"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_II34Fji9ZAJ5v8FFtTFx2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 official public holidays for a given country and year.","exampleAgentPrompt":"What are all the public holidays in Japan for 2025? I need the full list with dates and holiday names.","exampleUseCases":[{"title":"HR payroll calendar planning","prompt":"Can you get me all the official public holidays in Germany for 2025? We need to plan our payroll schedule around them."},{"title":"International project deadline check","prompt":"We're scheduling a product launch for March 17, 2025 — can you check what public holidays fall in Ireland that month so we avoid conflicts?"},{"title":"Travel itinerary around local holidays","prompt":"I'm visiting Brazil in June 2025 — can you pull up all the public holidays there so I know which days businesses might be closed?"}],"resultDescription":"A list of public holidays for the specified country and year, each including the holiday name, date, and typically the holiday type or category (e.g. national, regional, bank holiday).","failureModes":["Unsupported or invalid country code returns an error or empty result","Year out of supported range returns an error","Missing required parameters (country or year) returns a validation error","Network or worker timeout returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need a structured, machine-readable list of official public holidays for a specific country and year — especially for scheduling, payroll, travel planning, or date validation workflows. Prefer this over manual lookup or general web search when you need clean, structured data you can programmatically compare against dates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:53.746Z","isFirstParty":false}