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を指定した場合、fromtoは無視されます。
  • fromtoはどちらか一方だけを指定することもできます。

レスポンス

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

{
"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"