{"uid":"cap_KBhiLIrLBNrzKI2rXWMkO","slug":"coco-holidays-api-76590b35","name":"CoCo Holidays API","description":"Zach Riehn's lab: an about-me and portfolio, a news desk, The Atelier for AI experiments, Launch Lab for XRP research, and Fracture for games.","url":"https://cocoeatsai.com/area4/agent/tools/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"enum":["GET"]},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"const":"json"},"example":{"type":"object","required":["country"],"properties":{"country":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"year":2026,"country":"US","holidays":[{"date":"2026-01-01","name":"New Year's Day","weekday":"Thursday"},{"date":"2026-01-19","name":"Martin Luther King Jr. Day","weekday":"Monday"},{"date":"2026-02-16","name":"Washington's Birthday","weekday":"Monday"},{"date":"2026-05-25","name":"Memorial Day","weekday":"Monday"},{"date":"2026-06-19","name":"Juneteenth National Independence Day","weekday":"Friday"},{"date":"2026-07-03","name":"Independence Day (observed)","weekday":"Friday"},{"date":"2026-07-04","name":"Independence Day","weekday":"Saturday"},{"date":"2026-09-07","name":"Labor Day","weekday":"Monday"},{"date":"2026-10-12","name":"Columbus Day","weekday":"Monday"},{"date":"2026-11-11","name":"Veterans Day","weekday":"Wednesday"},{"date":"2026-11-26","name":"Thanksgiving Day","weekday":"Thursday"},{"date":"2026-12-25","name":"Christmas Day","weekday":"Friday"}],"subdivision":null},"exampleNote":"Computed offline with demonstration inputs; time/random values are illustrative."},"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_HACLwAjZptHWajMyTLe7m","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 public holidays for a given country (and optionally year/subdivision) as structured JSON.","exampleAgentPrompt":"Can you pull up all the public holidays for the US in 2026 so I can plan around them?","exampleUseCases":[{"title":"Business scheduling around holidays","prompt":"What are all the US federal holidays in 2026? I need to know which days to block off so our team doesn't schedule client calls on public holidays."},{"title":"International payroll compliance check","prompt":"List all public holidays in Germany for 2025 — I need to make sure we're accounting for them correctly in our payroll calendar."},{"title":"Travel planning around local holidays","prompt":"What public holidays does Canada observe this year? I'm planning a trip and want to avoid dates when businesses might be closed."}],"resultDescription":"A JSON object containing the country code, year, optional subdivision, and an array of holiday objects each with a date (YYYY-MM-DD), holiday name, and day of the week.","failureModes":["Unsupported or invalid country code returns an error or empty holiday list","Invalid year format may cause a bad request response","No subdivision filtering if the subdivision field is not supported for the requested country","Response may not include regional/state-level holidays unless subdivision is specified"],"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, compliance, or calendar automation tasks. It is ideal for lightweight lookup needs at low cost ($0.001 per call) without requiring a heavyweight calendar or HR platform integration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:44:39.190Z","isFirstParty":false,"canonicalSlug":"coco-holidays-api-76590b35"}