コンテンツにスキップ

祝日取得

/holiday [GET]

基本情報

概要

指定期間に含まれる祝日リストを返却します。

URL

https://{HOST}/{CID}/v1/holiday

※APIマーケットでは提供しておりません

出力形式

  • JSON

対応言語

  • ja

出力順

  • 日付の昇順

祝日のデータについて

祝日データは毎年12月に更新されます。
その際に前年分のデータが削除、来年分のデータが追加されます。

パラメータ

パラメータ名 必須 概要 型名 デフォルト値 上下限/選択値 備考
start_date 検索対象開始日 文字列(日付)
YYYY-MM-DD
現在日付 上限:現在日付から1年後まで
下限:現在日付から1年前まで
end_date 検索対象終了日 文字列(日付)
YYYY-MM-DD
現在日付から1年後 上限:現在日付から1年後まで
下限:現在日付から1年前まで

end_dateのみを指定する場合について

end_dateのみを指定する際に、現在日付より過去の日付を指定することはできません。ご注意ください。
start_dateは現在日付(デフォルト値)となり、検索対象期間の時系列に逆転が起きるためです。

例えば、2022年5月9日に/holiday?end_date=2022-05-08とリクエストした際にはエラーが返却されます。

パラメータ構成例

  • 2022年の祝日を検索
/holiday?start_date=2022-01-01&end_date=2022-12-31

レスポンス

名称 レスポンス名 型名 配列 説明
祝日情報 items HolidayInfoオブジェクト

HolidayInfoオブジェクト

名称 レスポンス名 型名 配列 説明
日付 date 文字列
曜日 day_of_week 文字列
祝日の名称 name 文字列

レスポンス例

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