{"uid":"cap_S44TXGm2RYlFpV5-OsQpu","slug":"lilambd-koyomi-public-holidays-lookup-9d305098","name":"Lilambd Koyomi — Public Holidays Lookup","description":"A crossing for play, feeling, language, science and computation — creating states that do not have names yet.","url":"https://api.lilambd.com/koyomi/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","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"lang":{"type":"string","description":"lang (string)"},"year":{"type":"string","description":"year (integer)"},"types":{"type":"string","description":"types (string)"},"subdiv":{"type":"string","description":"subdiv (string)"},"country":{"type":"string","description":"country (string)"}},"additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[],"count":0,"attribution":"source licence line"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-C09u26SVwSIRBbwPZRNh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","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 public holidays for a given country, year, and optional subdivision or type filter.","exampleAgentPrompt":"What are all the public holidays in Germany for 2025? Give me the full list including any regional ones for Bavaria.","exampleUseCases":[{"title":"Travel itinerary holiday awareness","prompt":"I'm planning a business trip to Japan in April 2025 — can you fetch the Japanese public holidays for that year so I know which days offices will be closed?"},{"title":"HR payroll calendar automation","prompt":"Pull the list of federal public holidays in the United States for 2025 so I can build out the team's payroll calendar for next year."},{"title":"Localized app calendar feature","prompt":"Get me all public holidays for Canada in 2025, specifically for the Quebec subdivision, and return them in French — I need to populate a calendar widget."}],"resultDescription":"A JSON object containing an array of holiday entries (dates and names) for the requested country and year, a count of results, and an attribution string crediting the data source license. Individual holiday objects likely include date, name, and possibly type or subdivision fields.","failureModes":["Missing required 'country' parameter returns a validation error","Invalid or unsupported country code returns empty data array or error","Unsupported year range may return empty results","Invalid subdivision code silently returns national holidays or empty set","Network or upstream data source unavailability returns 5xx error","Payment failure (x402) prevents access to the endpoint"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable public holiday data for a specific country and year, especially when you need subdivision-level granularity or multilingual holiday names. It is priced per-call at $0.05 USDC via x402 micropayment, making it suitable for on-demand lookups in agent workflows rather than bulk calendar generation. Prefer this over scraping government sites or using static datasets when freshness and attribution matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:35.169Z","isFirstParty":false,"canonicalSlug":"lilambd-koyomi-public-holidays-lookup-9d305098"}