{"uid":"cap_AyapZ6BPn6QI5WSaHIRCv","slug":"skyfeed-public-holidays-lookup-b178bea2","name":"SkyFeed Public Holidays Lookup","description":"Pay-per-call weather forecasts (global), current conditions, US severe-weather alerts, earthquakes, public holidays and a bundled travel check for AI agents. No API key: pay USDC on Base per call via x402.","url":"https://skyfeed.imac2014ville.workers.dev/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":{"year":{"type":"number","description":"Year 1990-2100 (default current year)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code, e.g. US, DE, JP"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"year":2026,"count":1,"source":"Nager.Date (open-source, MIT)","country":"US","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public","Bank"],"regions":null,"localName":"New Year's Day","nationwide":true}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M8x-m_UmytGQjR4HOJfmh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns public holidays for a given country and year using the Nager.Date open-source dataset.","exampleAgentPrompt":"What are all the public holidays in Japan for 2026? Give me the dates, names, and whether each one is nationwide.","exampleUseCases":[{"title":"Travel itinerary awareness","prompt":"I'm planning a business trip to Germany in May 2025 — can you tell me which days are public holidays there so I know when offices will be closed?"},{"title":"Payroll compliance calendar","prompt":"Pull all public and bank holidays in the US for 2026 so I can flag them in our payroll system as non-working days."},{"title":"App localization event scheduling","prompt":"I need a full list of nationwide public holidays in France for 2025 to configure our app's holiday notification feature."}],"resultDescription":"Returns a JSON object with the year, country code, total count of holidays, the data source (Nager.Date), and an array of holiday objects each containing the ISO date, English name, local name, holiday types (e.g. Public, Bank), applicable regions (null if nationwide), and a boolean nationwide flag.","failureModes":["Missing or invalid country code returns an error — must be valid ISO 3166-1 alpha-2","Year out of range (outside 1990–2100) may return an error or empty result","Payment failure (insufficient USDC balance on Base) results in 402 response before any data is returned","Country not supported by Nager.Date returns empty holiday list or error","No holidays found for given year/country combination returns count of 0 with empty array"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable public holiday data for a specific country and year, especially in agentic workflows that need to plan around non-working days, check compliance calendars, or enrich scheduling data. It is pay-per-call with no API key required, making it ideal for low-volume or on-demand lookups via x402/USDC on Base. Prefer it over scraping or static CSV datasets when freshness and structured output matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:30:06.634Z","isFirstParty":false,"canonicalSlug":"skyfeed-public-holidays-lookup-b178bea2"}