# Holiday Calendar API – Business Day Count

> Holiday Calendar API – Business Day Count is a paid API for AI agents from holidays.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Counts the number of business days between two dates for a given country, excluding weekends and full-day public or bank holidays.

## Facts

- Endpoint: GET https://holidays.use.x402atlas.com/business-days
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/holiday-calendar-api-business-day-count-5849e05e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7-JvqNGgb90w1Eyqk7Sad

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 holiday-calendar-api-business-day-count-5849e05e
```

Example prompt: How many business days are there between March 1 and March 31, 2025 in Germany (DE), excluding weekends and public holidays?

## When to prefer this

Choose this endpoint when you need an authoritative, precomputed count of business days between two dates for a specific country or regional subdivision, without having to maintain your own holiday database. It is ideal for payroll, SLA, contract, or billing calculations where accuracy against official public holiday calendars matters. Prefer this over generic date-math libraries that may lack up-to-date or country-specific holiday data.

## Known failure modes

- Unsupported country code returns a validation error — only the 36 listed ISO 3166-1 alpha-2 codes are accepted
- Date range exceeding 365 days returns an error
- Invalid date format (non-ISO 8601) causes a schema validation failure
- Subdivision code not matching the selected country prefix causes rejection
- Missing required parameters (country, from, to) returns a 400-level error
- Payment failure or insufficient USDC balance returns a 402 Payment Required error

## How this service works

Business-day count excluding weekends and full-day Public or Bank holidays; Optional and HalfDay observances remain business days.

## Output

Returns a JSON object with the queried country, date range (from/to), total calendar days, number of business days, weekend days, and holiday weekdays, along with the timestamp of the query. The business_days count excludes weekends and full-day Public or Bank holidays; Optional and HalfDay observances are counted as business days.

## Request schema (JSON Schema)

```json
{
 "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",
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "format": "date",
       "description": "Inclusive range end, at most 365 days after from"
      },
      "from": {
       "type": "string",
       "format": "date",
       "description": "Inclusive range start"
      },
      "country": {
       "enum": [
        "AD",
        "AL",
        "AT",
        "BE",
        "BG",
        "BR",
        "BY",
        "CH",
        "CZ",
        "DE",
        "EE",
        "ES",
        "FR",
        "HR",
        "HU",
        "IE",
        "IT",
        "LI",
        "LT",
        "LU",
        "LV",
        "MC",
        "MD",
        "MT",
        "MX",
        "NL",
        "PL",
        "PT",
        "RO",
        "RS",
        "SE",
        "SI",
        "SK",
        "SM",
        "VA",
        "ZA"
       ],
       "type": "string",
       "description": "Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Z]{2}$",
       "description": "Optional two-letter ISO 639-1 result language. Defaults to English when available."
      },
      "subdivision": {
       "type": "string",
       "pattern": "^[A-Z]{2}-.+$",
       "maxLength": 20,
       "description": "Optional regional subdivision code beginning with the selected country code, for example DE-BE."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "e
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-01-10",
  "from": "2026-01-01",
  "country": "DE",
  "queried_at": "2026-07-27T12:00:00Z",
  "total_days": 10,
  "subdivision": "DE-BE",
  "weekend_days": 3,
  "business_days": 6,
  "holiday_weekdays": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/holiday-calendar-api-business-day-count-5849e05e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holidays.use.x402atlas.com](https://www.zero.xyz/host/holidays.use.x402atlas.com/llms.txt)