{"uid":"cap_mfaF-fPS-_-REUjFQwLcp","slug":"busker-holidays-business-days-6e7390ba","name":"Busker Holidays & Business Days","description":"Public holidays for ~200 countries and their subdivisions, plus business-day arithmetic: is this date a holiday or business day, next business day, add N business days, count business days between dates. Configurable weekend and holiday types.","url":"https://workbot1.oddsys.org/holidays?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","description":"YYYY-MM-DD — count business days in [from, to] and list holidays inside."},"date":{"type":"string","description":"YYYY-MM-DD — is this date a holiday / business day, and the next business day."},"days":{"type":"integer","description":"Add this many business days to from (negative to subtract)."},"from":{"type":"string","description":"YYYY-MM-DD start date for days/to modes."},"year":{"type":"integer","description":"List all holidays in this year (default: current year) when no date/from is given."},"state":{"type":"string","description":"Subdivision code (e.g. CA for US-California, NSW for AU)."},"types":{"type":"array","items":{"enum":["public","bank","school","optional","observance"],"type":"string"},"description":"Holiday types that block a business day (default [public])."},"region":{"type":"string","description":"Sub-subdivision code where the ruleset has one."},"country":{"type":"string","description":"2-letter ISO country code (required)."},"weekend":{"type":"array","items":{"type":"integer"},"description":"Weekend weekdays 0=Sunday…6=Saturday (default [0,6])."}}},"responseSchema":null,"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_mZQoqb28g9IAF9pKcm8nW","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 ~200 countries/subdivisions and performs business-day arithmetic (is-holiday, next business day, add N business days, count between dates).","exampleAgentPrompt":"Is March 17, 2025 a business day in Ireland, and if not, what's the next business day? Use public holidays only and treat Saturday and Sunday as the weekend.","exampleUseCases":[{"title":"Payment due date calculation","prompt":"We need to pay an invoice net-30 business days from February 3, 2025 in the UK — skip weekends and public holidays and tell me what date that lands on."},{"title":"Cross-border payroll scheduling","prompt":"List all public holidays in Germany and the US-California for 2025 so I can identify days both offices are closed and plan our payroll runs around them."},{"title":"SLA deadline enforcement","prompt":"How many business days are there between April 1 and April 30, 2025 in Japan? I need to check if our 20-business-day SLA fits within that window."}],"resultDescription":"Returns a JSON object containing: holiday listings (name, date, type) for the queried period or year; boolean flags for whether a given date is a holiday and/or a business day; the date of the next business day; and the count of business days between two dates — all scoped to the requested country, subdivision, holiday types, and weekend configuration.","failureModes":["Missing or invalid country code returns an error (country is required)","Unrecognized subdivision/state code may return an empty or error response","Date format not matching YYYY-MM-DD causes a parse error","Conflicting mode parameters (e.g. both date and from/to) may produce unexpected results","Country with no supported holiday data returns empty holiday list","Invalid holiday type enum value rejected by schema validation"],"whenToPreferThis":"Choose this endpoint when you need authoritative, country-specific public holiday data combined with business-day arithmetic in a single call — especially for scheduling, payroll, SLA calculation, or deadline computation across ~200 countries and their regional subdivisions. It handles configurable weekend definitions (useful for Middle Eastern or custom work-week schedules) and multiple holiday type filters (public, bank, school, optional, observance), making it more flexible than generic calendar APIs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:42:24.636Z","isFirstParty":false,"canonicalSlug":"busker-holidays-business-days-6e7390ba"}