# Busker Holidays & Business Days

> Busker Holidays & Business Days is a paid API for AI agents from workbot1.oddsys.org, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns public holidays for ~200 countries/subdivisions and performs business-day arithmetic (is-holiday, next business day, add N business days, count between dates).

## Facts

- Endpoint: POST https://workbot1.oddsys.org/holidays?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/busker-holidays-business-days-6e7390ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mfaF-fPS-_-REUjFQwLcp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability busker-holidays-business-days-6e7390ba -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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])."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/busker-holidays-business-days-6e7390ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from workbot1.oddsys.org](https://www.zero.xyz/host/workbot1.oddsys.org/llms.txt)