Skip to main content

日本の祝日API

GET /v1/holidays?year=...​

「国民の祝日に関する法律」に定められた祝日を取得します。

year パラメーターを指定すると、指定された西暦の祝日を返します。指定しない場合は、現時点で内閣府が提供しているデータのうち1970年以降のデータを全て返します。

リソースURL​

https://api.kenall.jp/v1/holidays

パラメーター​

名前型必須かどうか説明例
yearstring省略可西暦で取得対象の年を指定します。"2021"
fromstring省略可YYYY-MM-DD形式で取得対象の開始年月日を指定します。取得範囲は指定した日を含みます。"2000-01-01"
tostring省略可YYYY-MM-DD形式で取得対象の終了年月日を指定します。取得範囲は指定した日を含みます。"2001-02-01"

パラメーターの注意事項​

  • パラメーターを全て省略した場合は1970年以降のデータを全て返します。
  • yearを指定した場合、fromとtoは無視されます。
  • fromとtoはどちらか一方だけを指定することもできます。

レスポンス​

以下はレスポンスの一例です。

{
  "data": [
    {
      "title": "元日",
      "date": "2022-01-01",
      "day_of_week": 6,
      "day_of_week_text": "saturday"
    },
    {
      "title": "成人の日",
      "date": "2022-01-10",
      "day_of_week": 1,
      "day_of_week_text": "monday"
    },
    {
      "title": "建国記念の日",
      "date": "2022-02-11",
      "day_of_week": 5,
      "day_of_week_text": "friday"
    },
    {
      "title": "天皇誕生日",
      "date": "2022-02-23",
      "day_of_week": 3,
      "day_of_week_text": "wednesday"
    },
    {
      "title": "春分の日",
      "date": "2022-03-21",
      "day_of_week": 1,
      "day_of_week_text": "monday"
    },
    {
      "title": "昭和の日",
      "date": "2022-04-29",
      "day_of_week": 5,
      "day_of_week_text": "friday"
    },
    {
      "title": "憲法記念日",
      "date": "2022-05-03",
      "day_of_week": 2,
      "day_of_week_text": "tuesday"
    },
    {
      "title": "みどりの日",
      "date": "2022-05-04",
      "day_of_week": 3,
      "day_of_week_text": "wednesday"
    },
    {
      "title": "こどもの日",
      "date": "2022-05-05",
      "day_of_week": 4,
      "day_of_week_text": "thursday"
    },
    {
      "title": "海の日",
      "date": "2022-07-18",
      "day_of_week": 1,
      "day_of_week_text": "monday"
    },
    {
      "title": "山の日",
      "date": "2022-08-11",
      "day_of_week": 4,
      "day_of_week_text": "thursday"
    },
    {
      "title": "敬老の日",
      "date": "2022-09-19",
      "day_of_week": 1,
      "day_of_week_text": "monday"
    },
    {
      "title": "秋分の日",
      "date": "2022-09-23",
      "day_of_week": 5,
      "day_of_week_text": "friday"
    },
    {
      "title": "スポーツの日",
      "date": "2022-10-10",
      "day_of_week": 1,
      "day_of_week_text": "monday"
    },
    {
      "title": "文化の日",
      "date": "2022-11-03",
      "day_of_week": 4,
      "day_of_week_text": "thursday"
    },
    {
      "title": "勤労感謝の日",
      "date": "2022-11-23",
      "day_of_week": 3,
      "day_of_week_text": "wednesday"
    }
  ]
}

レスポンスのデータは以下のような構成になっています。

名前型説明例
dataarray以下に示すカレンダーデータの配列

カレンダーデータは以下のような構造になっています。

名前型説明例
titlestring祝日の名称"春分の日"
datestring日付をYYYY-MM-DD形式で表したもの"2022-03-21"
day_of_weeknumber曜日を0から6の整数値で表したもの。詳細は曜日とレスポンスフィールドの対応表を参照1
day_of_week_textstring曜日を文字列で表したもの。詳細は曜日とレスポンスフィールドの対応表を参照"thursday"

曜日とレスポンスフィールドの対応表​

曜日day_of_weekday_of_week_text
日曜日0"sunday"
月曜日1"monday"
火曜日2"tuesday"
水曜日3"wednesday"
木曜日4"thursday"
金曜日5"friday"
土曜日6"saturday"