{"uid":"cap_46GspJDCyzknyTVXmbQPe","slug":"workday-calendar-api-public-holidays-8ea91020","name":"Workday Calendar API – Public Holidays","description":"All national public holidays for a country and year, with weekend definition and official weekend make-up workdays.","url":"https://workday-calendar.regnotes.workers.dev/v1/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","pattern":"^\\d{4}$"},"country":{"enum":["US","CA","MX","BR","AR","CL","CO","PE","GB","IE","FR","DE","NL","BE","LU","CH","AT","IT","ES","PT","SE","NO","DK","FI","PL","CZ","HU","RO","GR","TR","IL","AE","SA","EG","ZA","NG","KE","IN","PK","BD","LK","SG","MY","ID","TH","VN","PH","HK","TW","CN","JP","KR","AU","NZ","UA"],"type":"string","description":"ISO 3166-1 alpha-2 country code"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"China","year":2026,"count":1,"country":"CN","weekend":[6,7],"holidays":[{"date":"2026-10-01","name":"National Day"}],"weekend_workdays":["2026-10-10"]}},"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_iqWNukQyL288ip3gq6xwB","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 all national public holidays for a given country and year, including weekend definitions and official make-up workdays.","exampleAgentPrompt":"Can you get me the full list of public holidays in Japan for 2025, including any weekend make-up workdays?","exampleUseCases":[{"title":"Payroll compliance for international team","prompt":"I need to know all official public holidays in Germany for 2025 so I can make sure our payroll system skips them correctly — can you pull the full list including any make-up workdays?"},{"title":"Project deadline planning across markets","prompt":"We're planning a product launch timeline for China and need to know every national holiday and official make-up workday in 2026 so we don't schedule deliverables on non-working days."},{"title":"Employee leave calendar for HR portal","prompt":"Can you fetch all public holidays for India in 2025 so I can populate our HR leave calendar? I also need to know which days count as the weekend there."}],"resultDescription":"A JSON object containing the country name and code, the requested year, a list of holiday objects (each with a date in YYYY-MM-DD format and holiday name), the total holiday count, an array of integers representing weekend days (e.g. [6,7] for Sat/Sun), and a list of official make-up workday dates when weekend rest days are compensated.","failureModes":["Unsupported country code returns an error (only the enumerated ISO codes are accepted)","Invalid year format (non-4-digit) causes a validation error","Missing required parameters (country or year) results in a 400-level error","Some countries may have incomplete or no make-up workday data, returning an empty array","Rate limiting or payment failure could result in a 402 or 429 response"],"whenToPreferThis":"Use this endpoint when you need a structured, machine-readable list of national public holidays and weekend definitions for a specific country and year, especially when you also need official make-up workday data (common in East Asian countries). It supports 50+ countries and is ideal for payroll, HR, scheduling, and compliance workflows. Prefer this over general-purpose calendar APIs when you need the weekend day definition per country and compensatory workday dates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:03:59.744Z","isFirstParty":false,"canonicalSlug":"workday-calendar-api-public-holidays-8ea91020"}