lapius7.com API · 認証不要
祝日API
日本の祝日をJSONで返すAPI。内閣府が公開している「国民の祝日」データを元に、指定日が祝日・休日・営業日かを判定したり、年ごとの祝日一覧を取得できる。
エンドポイント
-
GET
/:dateYYYY-MM-DD の祝日・営業日を判定 -
GET
/year/:year指定年の祝日一覧
使用例
指定日が祝日か判定
curl "https://holiday.api.lapius7.com/2026-11-23"
レスポンス例
{
"date": "2026-11-23",
"weekday": "月",
"isHoliday": true,
"holidayName": "勤労感謝の日",
"isWeekend": false,
"isBusinessDay": false
}年の祝日一覧
curl "https://holiday.api.lapius7.com/year/2027"
レスポンス例
{
"year": 2027,
"count": 16,
"holidays": [{ "date": "2027-01-01", "name": "元日" }, ...],
"updatedAt": "2026-11-20T00:00:00.000Z"
}注意事項
- データ元: 内閣府「国民の祝日について」(syukujitsu.csv)。1日ごとに自動更新します。
- 対象は内閣府データの収録範囲(過去〜翌年まで)です。範囲外の年は400を返します。
- 営業日は土日と祝日を除いた日です。年末年始や会社ごとの休業日は含みません。
- レート制限: 1IPあたり1分間に60リクエストまで。