祝日取得

/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": "勤労感謝の日"
        }
    ]
}