# Kaisha Japanese Business Day Calculator

> Kaisha Japanese Business Day Calculator is a paid API for AI agents from kaisha-api.hp-vladic.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Checks if a date is a Japanese business day, adds N business days to a date, or counts business days in a range, accounting for Japanese national holidays and optional Saturday/year-end rules.

## Facts

- Endpoint: GET https://kaisha-api.hp-vladic.workers.dev/calendar/business-days
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kaisha-japanese-business-day-calculator-38feec1e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OP1Jt_dNE53-LRNL7f8Rn

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 kaisha-japanese-business-day-calculator-38feec1e
```

Example prompt: How many Japanese business days are there between 2024-12-20 and 2025-01-15, treating Saturdays and the year-end/new-year break as non-working days?

## When to prefer this

Use this endpoint when you need Japan-specific business day calculations that account for official Japanese national holidays from the Cabinet Office dataset. Prefer this over generic weekday calculators when the context is Japanese business, finance, contracts, or HR operations. Especially useful when Saturday-off or year-end/new-year break rules are relevant to the calculation.

## Known failure modes

- Missing required 'from' date parameter returns an error
- Invalid date format (non-YYYY-MM-DD) causes a parsing failure
- Year outside supported holiday data range may return incomplete results
- Conflicting mode parameters (both 'add' and 'to' specified) may cause ambiguous behavior
- Network timeout from the Cloudflare Worker edge

## How this service works

Japanese business-day calculator: check if a date is a business day, add N business days to a date, or count business days in a range. Accounts for weekends and Japanese national holidays; optional Saturday and year-end/new-year rules.

## Output

Returns whether a given date is a Japanese business day, the resulting date after adding N business days, or the count of business days within a specified date range — all adjusted for Japanese national holidays and optional Saturday/new-year-break rules.

## 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": [],
     "properties": {
      "to": {
       "type": "string",
       "description": "End date YYYY-MM-DD (mode B: count)"
      },
      "add": {
       "type": "number",
       "description": "Add N business days (mode A)"
      },
      "from": {
       "type": "string",
       "description": "Start date YYYY-MM-DD"
      },
      "saturday_off": {
       "type": "boolean"
      },
      "new_year_break": {
       "type": "boolean"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "from": "2026-07-17",
  "result": "2026-07-27",
  "addBusinessDays": 5,
  "resultIsHoliday": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kaisha-japanese-business-day-calculator-38feec1e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kaisha-api.hp-vladic.workers.dev](https://www.zero.xyz/host/kaisha-api.hp-vladic.workers.dev/llms.txt)