# Japan National Holiday Listing API

> Japan National Holiday Listing API is a paid API for AI agents from holiday.agentic-jp.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns a list of all Japanese national public holidays (国民の祝日) for a specified year, with English names and dates.

## Facts

- Endpoint: GET https://holiday.agentic-jp.com/holidays/:year
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-national-holiday-listing-api-efb310a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VVbrYFI9uStlx-6jl_Zv2

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-national-holiday-listing-api-efb310a2
```

Example prompt: Can you list all the Japanese national public holidays for 2025 with their English names?

## When to prefer this

Choose this endpoint when you need the complete set of Japanese national holidays for an entire year with English-language names — ideal for building calendars, scheduling tools, HR systems, or travel planners targeting Japan. Prefer this over the date-classification or business-day-count endpoints when you need a full annual list rather than checking a specific date or range.

## Known failure modes

- Year out of supported range (1955–2027) — returns an error or empty response
- Invalid year format (non-integer, empty) — returns a 400-level error
- Network timeout or service unavailability — returns a 5xx error
- Payment not processed via x402 — returns a 402 Payment Required response

## How this service works

List every Japanese (JP) national public holiday (国民の祝日) in a given year, with English names.

## Output

A structured list of all Japanese national public holidays (国民の祝日) for the requested year, each entry including the holiday date and its English name. Covers years from 1955 through 2027.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-national-holiday-listing-api-efb310a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holiday.agentic-jp.com](https://www.zero.xyz/host/holiday.agentic-jp.com/llms.txt)