{"uid":"cap_qmaCl89Tc7Jugf9gvQYOw","slug":"agent-tools-national-public-holidays-lookup-dd696d4a","name":"Agent Tools – National Public Holidays Lookup","description":"List national public holidays for a country and year.","url":"https://agent-tools.jbarkules.workers.dev/v1/time/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","year"],"properties":{"year":{"type":"string","description":"Year, e.g. 2027"},"country":{"type":"string","description":"ISO 3166 alpha-2"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2027,"country":"US","holidays":[{"date":"2027-01-01","name":"New Year's Day","global":true,"local_name":"New Year's Day"}]}},"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_utJ1hcgvPH4GdsfcKgqts","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 national public holidays for a given country and year using ISO 3166 alpha-2 country codes.","exampleAgentPrompt":"Can you pull up all the national public holidays in Germany for 2026?","exampleUseCases":[{"title":"Business day scheduling across borders","prompt":"I need to schedule meetings with our UK team next year — can you list all national public holidays in the UK for 2025 so I know which days to avoid?"},{"title":"HR payroll calendar planning","prompt":"We're building our payroll calendar for 2027 — what are all the official national public holidays in the US for 2027?"},{"title":"Travel itinerary awareness","prompt":"I'm planning a trip to Japan in 2026 and want to know all the national public holidays so I can plan around busy periods — can you get that list for me?"}],"resultDescription":"A JSON object containing the queried country (ISO alpha-2 code), the year, and an array of holiday objects each with a date (YYYY-MM-DD format) and the official holiday name.","failureModes":["Invalid or unsupported ISO 3166 alpha-2 country code returns an error or empty results","Year parameter missing or malformed causes a 400-level error","Country with no data in the system may return an empty holidays array","Network or Cloudflare Workers timeout for transient failures"],"whenToPreferThis":"Choose this endpoint when you need a quick, structured list of national public holidays for a specific country and year, especially within automated scheduling, payroll, or business-day calculation workflows. It complements the sibling business-day-counting endpoint. Prefer it over scraping government sites or general web search when you need clean, machine-readable date data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:43:44.546Z","isFirstParty":false,"canonicalSlug":"agent-tools-national-public-holidays-lookup-dd696d4a"}