# JP Calendar X402 - Japanese Holiday Checker

> JP Calendar X402 - Japanese Holiday Checker is a paid API for AI agents from jp-calendar-x402.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Check if a given date is a Japanese public holiday, weekend, or business day, and return the official Japanese holiday name if applicable

## Facts

- Endpoint: POST https://jp-calendar-x402.onrender.com/v1/check
- 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/jp-calendar-x402-japanese-holiday-checker-62b2237e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4SS_Ll7kmfb7qpJ5Arf-0

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 jp-calendar-x402-japanese-holiday-checker-62b2237e -d '<json body>'
```

Example prompt: Is March 21, 2026 a Japanese public holiday or a regular business day? If it's a holiday, what's the official Japanese name for it?

## When to prefer this

Use this endpoint when you need to determine the holiday status of a specific single date in Japan for years 2026-2027, including substitute holidays (振替休日). Prefer this over the sibling list endpoint when you only need to check one date rather than enumerate all holidays in a year, and over the business-day-count endpoint when you don't need a range calculation.

## Known failure modes

- Date out of supported range (2026-2027) — may return an error or empty result
- Invalid date format (non-YYYY-MM-DD) — likely returns a 400 bad request
- Payment failure via x402 protocol — returns 402 Payment Required if USDC payment is not attached
- Missing date parameter — returns 400 or validation error

## How this service works

Check whether a given date is a Japanese public holiday, a weekend, or a business day. Returns the official holiday name in Japanese (e.g. 憲法記念日, 振替休日) when the date is a holiday. Substitute holidays (振替休日) are included. Covers years 2026-2027. Cost: $0.001 USDC per request.

## Output

Returns a JSON object with the queried date, its day of week (e.g. Mon), whether it is a Japanese public holiday (isHoliday boolean), whether it is a weekend (isWeekend boolean), whether it is a business day (isBusinessDay boolean), and the official Japanese holiday name (e.g. 春分の日) or null if it is not a holiday.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jp-calendar-x402-japanese-holiday-checker-62b2237e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from jp-calendar-x402.onrender.com](https://www.zero.xyz/host/jp-calendar-x402.onrender.com/llms.txt)