List Japanese national holidays / 日本の祝日の一覧

List all Japanese national holidays and substitute holidays for a year, based on the National Holidays Act and verified against the Cabinet Office CSV. Each holiday has name (descriptive) and official_name (as written by the Cabinet Office). / その年の国民の祝日・休日(振替休日・国民の休日を含む)の一覧。name は内容がわかる名前、official_name は内閣府の表記。

get/v1/holidays

Request

  • Base URL: https://biz.ossalt.jp
  • URL: https://biz.ossalt.jp/v1/holidays
  • Auth: none declared

Query parameters

yearinteger required

Year (1980-2099) / 年

Response

OK

resultobject required

The answer / 結果

sourceobject required

Source and verification / 出典と照合の状況

as_ofstring required

Reference date in Japan time (YYYY-MM-DD) / 基準日(日本時間)

notesstring[] required

Assumptions such as estimated values / 前提(見込みの値など)

flagsstring[] required

flags holds machine-readable codes: estimated (a value is an estimate, e.g. a future equinox day — tell the user), unverified (year not yet checked against Cabinet Office data — tell the user), assumes_current_era (a future date written in the current era — tell the user), outside_era (the era date given is outside that era), weekday_mismatch, closed (the company's registry record is closed — tell the user), excluded_from_search, truncated, not_found, exact_match_only, partial, ambiguous, city_not_found, ambiguous_city.

Changes

No recorded changes to this operation across all 1 revision of this API.