---
name: kaisha-api.hp-vladic.workers.dev
description: This host provides a single endpoint that returns the official list of Japanese national public holidays for a specified year, sourced from the Cabinet Office of Japan. It covers years from 1955 through 2027 and returns dated entries with Japanese holiday names.
host: kaisha-api.hp-vladic.workers.dev
---

# kaisha-api.hp-vladic.workers.dev

kaisha-api.hp-vladic.workers.dev is a narrow, single-purpose API focused exclusively on Japan's official public holiday calendar. It serves agents and applications that need authoritative holiday data for scheduling, business-day calculations, or date validation in a Japanese context. Its data source is the Cabinet Office of Japan, making it suitable for compliance-sensitive or official use cases within that geographic scope.

## When to use this host

Use this host when an agent needs the official Japanese public holiday list for a specific year between 1955 and 2027, such as for scheduling tasks, filtering business days, or validating dates in a Japan-specific context. Do not use it for holidays in any country other than Japan, for years outside the 1955–2027 range, or for real-time calendar data. For general international holiday data or multi-country calendar support, a broader holiday API would be more appropriate.

## Capabilities

### Japan Holiday Calendar

Retrieves the complete list of Japanese national public holidays for a given year, including holiday names in Japanese, as published by the Cabinet Office of Japan.

- **`fetch-japan-public-holidays`** — Returns Japanese national public holidays for a given year (1955–2027), sourced from the Cabinet Office of Japan, as a dated list with Japanese holiday names.

## Skill reference

### `fetch-japan-public-holidays`

**Japan Holiday Calendar** — Returns Japanese national public holidays for a given year (1955–2027), sourced from the Cabinet Office of Japan, as a dated list with Japanese holiday names.

*Use when:* Use when an agent needs the official list of Japanese public holidays for a specific year, such as for scheduling, date validation, or business-day calculations involving Japan.

*Not for:* Do not use for holidays outside Japan, or for years outside the 1955–2027 range. Not suitable for real-time or sub-daily calendar data.

**Inputs:**

- `year` (integer) — The calendar year for which to retrieve Japanese public holidays. Must be between 1955 and 2027 inclusive. Defaults to the current year if omitted.

**Returns:** Returns a JSON object with the requested year, source attribution from the Cabinet Office of Japan, and an array of 18 dated public holidays with Japanese names.

**Example:** `GET https://kaisha-api.hp-vladic.workers.dev/calendar/holidays?year=2026`

---