{"uid":"cap_OS7mFLA8FVGSVbHJCM5Yb","slug":"agenttools-public-holidays-lookup-d8fda987","name":"AgentTools Public Holidays Lookup","description":"List upcoming or full-year public holidays for any covered country via Nager.Date — names, dates and whether they're nationwide. Essential for scheduling agents. Use this when an agent needs to upcoming public holidays for ~110 countries.","url":"https://agentstoolshub.com/api/v1/live/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"],"properties":{"op":{"enum":["next","year"],"type":"string","description":"Query"},"year":{"type":"number","description":"Year (for full-year list)"},"count":{"type":"number","description":"Max results"},"country":{"type":"string","description":"Country (ISO-2)"}}}},"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_OeqoajAvHwyW8nhshL3K3","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 upcoming or full-year public holidays for any of ~110 covered countries, including holiday names, dates, and nationwide status.","exampleAgentPrompt":"What are the upcoming public holidays in Germany? Show me the next 5 nationwide ones.","exampleUseCases":[{"title":"Scheduling around holidays for project planning","prompt":"I'm planning a sprint that spans late January in France — can you pull the next 3 public holidays there so I can avoid scheduling deadlines on them?"},{"title":"Full-year holiday calendar for HR policy","prompt":"Can you give me the complete list of public holidays in Canada for 2025? I need it for our employee leave policy document."},{"title":"Checking holidays before booking international travel","prompt":"I'm flying to Japan in May — what are the public holidays there in 2025 so I know what to expect with closures?"}],"resultDescription":"Returns a list of public holiday objects for the specified country, each containing the holiday date, name, and whether it is a nationwide (country-wide) or regional holiday. For 'next' mode, returns the upcoming N holidays from today; for 'year' mode, returns all holidays in the specified calendar year.","failureModes":["Unsupported country code returns an error or empty list — only ~110 countries are covered by Nager.Date","Missing required 'country' query parameter results in a 400-level error","Invalid ISO-2 country code returns no results or an error","Year out of supported range may return empty or error","Network or upstream Nager.Date service outage causes 5xx response"],"whenToPreferThis":"Choose this endpoint when an agent needs structured, machine-readable public holiday data for scheduling, planning, or calendar enrichment across a broad set of countries. It is ideal for scheduling agents, HR tools, travel planners, or any workflow that needs to avoid or account for public holidays. Prefer it over scraping government websites or relying on LLM knowledge, which may be outdated or hallucinated.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:40:56.935Z","isFirstParty":false,"canonicalSlug":"agenttools-public-holidays-lookup-d8fda987"}