# Japan Public Holiday Calendar API (kasanegi.com)

> Japan Public Holiday Calendar API (kasanegi.com) is a paid API for AI agents from kasanegi.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns a list of Japanese national public holidays for a given year (2024–2027).

## Facts

- Endpoint: GET https://kasanegi.com/v1/local/holiday/jp
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-public-holiday-calendar-api-kasanegi-com-b708aff3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LQyz1qe1bGbCHgJQhlaBM

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 japan-public-holiday-calendar-api-kasanegi-com-b708aff3
```

Example prompt: Can you give me the full list of Japanese national public holidays for 2025? I need them for payroll and scheduling.

## When to prefer this

Use this endpoint when you need a clean, structured, machine-readable list of Japanese national public holidays without scraping government sites. Ideal for payroll calculations, business-day scheduling, or calendar enrichment involving Japan. Prefer this over web scraping or generic calendar APIs when accuracy and reliability for Japanese official holidays are required.

## Known failure modes

- Year out of range (below 2024 or above 2027) — likely returns an error or empty result
- Missing or invalid query parameter format — may return a 400 bad request
- Payment not included or insufficient — returns HTTP 402 Payment Required
- Network or upstream data source unavailable — returns 5xx error

## How this service works

Stop scraping Japanese government and public-data sites. Call clean Japan payroll, company, and grant APIs over one host. Preview free; one public marketplace listing covers all current products; x402 direct is available for agent-native buyers.

## Output

A JSON array of Japanese national public holidays for the requested year, including holiday dates and names, covering the range 2024–2027.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "year": {
       "type": "integer",
       "maximum": 2027,
       "minimum": 2024,
       "description": "Year 2024-2027. Default current year."
      },
      "verbose": {
       "type": "string",
       "description": "Verbose flag."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-public-holiday-calendar-api-kasanegi-com-b708aff3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kasanegi.com](https://www.zero.xyz/host/kasanegi.com/llms.txt)