日本の祝日API リファレンス

エンドポイント一覧この見出しへのリンク

共通仕様この見出しへのリンク

GET /v1/holidaysこの見出しへのリンク

リソースURLこの見出しへのリンク

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

クエリパラメータこの見出しへのリンク

パラメータ組み合わせこの見出しへのリンク

• year 指定時: from/to は無視。その年の祝日全件を返す
• from のみ: その日付以降の祝日を返す
• to のみ: その日付以前の祝日を返す
• from + to: 期間内の祝日を返す
• すべて省略: 1970年以降のすべての祝日を返す

curl サンプルこの見出しへのリンク

# 西暦年指定で取得
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/holidays?year=2021"
 
# 期間指定で取得
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/holidays?from=2000-01-01&to=2001-02-01"

レスポンス例この見出しへのリンク

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

レスポンスフィールドこの見出しへのリンク

day_of_week コード対応この見出しへのリンク

振替休日・国民の休日の扱いこの見出しへのリンク

• 振替休日: 祝日が日曜日と重なった場合の翌月曜日
• 国民の休日: 2つの祝日に挟まれた平日 (例: 5月4日)
• 祝日法に基づく振替休日・国民の休日も、通常の祝日と同じ形式で data 配列に含まれます

GET /v1/businessdays/check — 土日・祝日判定この見出しへのリンク

指定した日が土日・祝日かどうかを判定します。土日・祝日 = 土曜・日曜・国民の祝日・振替休日・国民の休日。配送日計算・N営業日後算出・締切日チェックに利用できます。

リソースURLこの見出しへのリンク

https://api.kenall.jp/v1/businessdays/check

クエリパラメータこの見出しへのリンク

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/businessdays/check?date=2000-01-01"

レスポンス例この見出しへのリンク

{"result": false}

レスポンスフィールドこの見出しへのリンク

判定の定義この見出しへのリンク

true を返す条件:

• 土曜日
• 日曜日
• 国民の祝日 (祝日法に基づく)
• 振替休日 (祝日が日曜と重なった場合の翌月曜)
• 国民の休日 (2つの祝日に挟まれた平日)

SDK で呼び出す (土日・祝日判定)この見出しへのリンク

import { KENALL } from '@ken-all/kenall';
const api = new KENALL('YOUR_API_KEY');
 
const result = await api.checkBusinessDay('2026-01-01');
console.log(result.result); // => true (元日)

N営業日後の算出はクライアント側のループで実装します (Python例):

import os, requests
from datetime import date, timedelta
 
HEADERS = {"Authorization": f"Token {os.environ['KENALL_API_KEY']}"}
 
def is_holiday(d):
    res = requests.get(
        "https://api.kenall.jp/v1/businessdays/check",
        headers=HEADERS,
        params={"date": d.isoformat()},
        timeout=10,
    )
    return res.json()["result"]
 
def n_business_days_later(start, n):
    """startからN営業日後の日付を返す"""
    current = start
    days_added = 0
    while days_added < n:
        current += timedelta(days=1)
        if not is_holiday(current):
            days_added += 1
    return current
 
# 例: 2026-01-01 から3営業日後
print(n_business_days_later(date(2026, 1, 1), 3))

HTTPステータス・エラーこの見出しへのリンク

SDK で呼び出すこの見出しへのリンク

JavaScript SDKこの見出しへのリンク

import { KENALL } from '@ken-all/kenall';
const api = new KENALL('YOUR_API_KEY');
 
const holidays = await api.getHolidays({ year: 2026 });
console.log(holidays.data.length);          // => その年の祝日件数
console.log(holidays.data[0].title);        // => 元日

Pythonこの見出しへのリンク

import os, requests
res = requests.get(
    "https://api.kenall.jp/v1/holidays",
    headers={"Authorization": f"Token {os.environ['KENALL_API_KEY']}"},
    params={"year": 2026},
    timeout=10,
)
for h in res.json()["data"]:
    print(h["date"], h["title"])

注意事項この見出しへのリンク

• データ源は内閣府: 「国民の祝日に関する法律」 (祝日法) に基づく祝日
• 未来の祝日: 法改正・天皇即位等で新設・変更される可能性があるため、年次バッチで再取得することを推奨
• 会社固有の休日 (夏季休暇・年末年始) は含まれません。これらは自社カレンダーと併用
• 指定日が土日・祝日かの判定は、本APIに同梱の 土日・祝日判定 を利用

このAPIに関する技術FAQこの見出しへのリンク

OpenAPI スキーマこの見出しへのリンク

OpenAPI スキーマ (YAML): 2023-09-01 / 2024-01-01 / 2025-01-01

関連リファレンスこの見出しへのリンク

• ⚠️ 既知の問題 (このAPIに該当する制約・破壊的変更)
• API共通仕様
• 営業日API (準備中) — 任意の営業日設定・N営業日後の算出などを予定

外部参考リソースこの見出しへのリンク

• 内閣府『「国民の祝日」について』

最終更新: 2026-07-17