# Japan Public Holidays API (kasanegi.com)

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

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

## Facts

- Endpoint: GET https://api.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-holidays-api-kasanegi-com-675a3c38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v3SiKKvaWy-s677xf2w7k

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-holidays-api-kasanegi-com-675a3c38
```

Example prompt: Can you get me the full list of official Japanese public holidays for 2025 from kasanegi's Japan public data API?

## When to prefer this

Use this endpoint when you need structured, clean Japanese public holiday data without scraping government sites — especially for payroll calculations, business day scheduling, HR automation, or calendar integrations targeting Japan. Prefer this over scraping when you need reliable, machine-readable holiday data for years 2024–2027.

## Known failure modes

- Year out of range (below 2024 or above 2027) — likely returns 400 or validation error
- Network/payment failure — 402 if payment not provided, 5xx on server error
- No data for the requested year if not yet available
- Malformed query parameter returns 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 or object listing all official Japanese national public holidays for the requested year, including dates and holiday names, sourced from Japanese government public data.

## 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-holidays-api-kasanegi-com-675a3c38/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.kasanegi.com](https://www.zero.xyz/host/api.kasanegi.com/llms.txt)