Service
Uses the Cabinet Office's official holiday CSV and Japan's statutory year-end office closure to list holidays, check dates, find the next holiday, and calculate Japanese public-office business days.
100.00%30-day uptimeAvg response49ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/japan-public-holidays/holiday | Check whether one covered ISO date is an official Japanese public holiday and return its official holiday record when present. Use when the question is only about a date's holiday status or the holiday's name and type. Do NOT use to decide whether a public office is open on that date — use japan-public-holidays:office-business-day instead. date is read as a Japan Standard Time (JST, UTC+09:00) calendar date. Returns is_holiday, holiday (the record, or null for a non-holiday), coverage_start_date, and coverage_end_date. | |
| POST | /v1/japan-public-holidays/holidays | List the official Japanese public holidays in one calendar year. Use when the user needs every holiday in a year or wants to browse a year's holiday names and types. Do NOT use to check a single date — use japan-public-holidays:holiday instead. Years are limited to the Cabinet Office source coverage, which starts in 1955. The year is the Japan Standard Time (JST, UTC+09:00) calendar year. Returns items, summary, coverage_start_date, and coverage_end_date. | |
| POST | /v1/japan-public-holidays/next-holiday | Find the next official Japanese public holiday after from_date within the Cabinet Office source coverage; set include_from_date to true to allow a holiday on from_date itself. Use when the user asks when the next holiday is or how many days remain until it. Do NOT use to move a date by public-office business days — use japan-public-holidays:office-business-day-shift instead. from_date is read as a Japan Standard Time (JST, UTC+09:00) calendar date, and days_until counts JST calendar days. Returns holiday, days_until, and coverage_end_date. | |
| POST | /v1/japan-public-holidays/office-business-day | Check whether one date is a Japanese public-office business day, treating weekends, official public holidays, and the December 29 through January 3 office closure as non-business days. Use when the question is whether a Japanese government office is open on a date. Do NOT use when only the holiday status or holiday name matters — use japan-public-holidays:holiday instead. This does not model bank or private-company calendars. date is read as a Japan Standard Time (JST, UTC+09:00) calendar date, so the weekend is Japan's. Returns is_business_day, reason, and holiday (the record only when reason is public_holiday; otherwise null). |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
| POST | /v1/japan-public-holidays/office-business-day-shift | Move forward or backward from start_date by a number of Japanese public-office business days, skipping weekends, official public holidays, and the December 29 through January 3 office closure. Use when the user needs the date that is N public-office business days before or after a given date. Do NOT use to check a single date — use japan-public-holidays:office-business-day instead. Do NOT use to find the next public holiday — use japan-public-holidays:next-holiday instead. Counting starts on the date adjacent to start_date, every date must stay within the source coverage, and this does not model bank or private-company calendars. start_date, result_date and every skipped date are Japan Standard Time (JST, UTC+09:00) calendar dates. Returns result_date and skipped_dates. |
