# JP Calendar - List Japanese Public Holidays by Year

> JP Calendar - List Japanese Public Holidays by Year is a paid API for AI agents from jp-calendar-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns a list of all Japanese public holidays for a given year, with dates and official Japanese names.

## Facts

- Endpoint: POST https://jp-calendar-x402.onrender.com/v1/holidays
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jp-calendar-list-japanese-public-holidays-by-year-86d8fcef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_40DKgi1iPz6gCHe3suaDo

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-list-japanese-public-holidays-by-year-86d8fcef -d '<json body>'
```

Example prompt: Can you pull up all the official Japanese public holidays for 2026, including their names and exact dates?

## When to prefer this

Use this endpoint when you need the complete list of all Japanese public holidays for an entire year in a single call, rather than checking dates one-by-one. Ideal for populating yearly calendar views, scheduling systems, or any application that needs to know all Japanese national holiday dates upfront. Currently covers only 2026 and 2027.

## Known failure modes

- Year outside supported range (2026-2027) may return an error or empty result
- Missing or malformed year query parameter returns a validation error
- Payment failure (insufficient USDC balance) returns a 402 Payment Required response
- Service unavailable on Render free-tier cold start may cause timeout on first request

## How this service works

List every Japanese public holiday in a given year, with each date and its official Japanese name. Useful for building a yearly calendar in one call instead of checking dates individually. Covers years 2026-2027. Cost: $0.002 USDC per request.

## Output

Returns a JSON object with the queried year echoed back and an array of holiday objects, each containing a date string in YYYY-MM-DD format and the official Japanese holiday name. Typically 16-20 entries ordered chronologically by date.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jp-calendar-list-japanese-public-holidays-by-year-86d8fcef/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)