日本の祝日API — その年の祝日、まとめて返す。

要約: 内閣府公開データに基づく日本の祝日を返す REST API。振替休日・国民の休日も含む。配送日計算・予約システム・カレンダーアプリ・土日・祝日の判定に利用。5,500円/月（税込）〜商用利用可。

ISMS認証取得5,500円/月（税込）〜土日・祝日判定も含むフリープランあり

このAPIで出来ること (デモンストレーション)

このAPIが返すデータは、下のサンプル行を押すとその場で確認できます。指定年の祝日一覧を取得するパターンを体験してください。

年 (西暦4桁) を入力してください

👇 各行を 押してみてください。そのまま自動で検索が走ります。

サンプル年

レスポンス200 OK

年を入力すると、JavaScript SDK (api.getHolidays()) で 実際のAPIレスポンスをその場で取得します。2026年は振替休日 (5/6) ・国民の休日 (9/22)も含めて返します。任意の年を入力して確認できます。

土日・祝日判定 (このプランに含まれます)

日本の祝日APIと同じスタンダードプランで、指定日が土日・祝日 (振替休日を含む) かどうかを判定する土日・祝日判定にも対応しています。配送日計算・締切日チェック・N営業日後の算出・支払期日の繰り下げなどに使えます。土日・祝日を営業日とするか休業日とするかは事業者ごとに異なるため、会社固有の休日 (年末年始・夏季休暇等) とあわせて自社の営業カレンダーで扱ってください。

エンドポイント: GET /v1/businessdays/check?date=YYYY-MM-DD。result が true なら土日・祝日 (振替休日を含む)、false なら平日です。

日付 (YYYY-MM-DD) を入力してください

👇 各行を 押してみてください。そのまま自動で判定が走ります。

サンプル日日付

レスポンス200 OK

サンプルを押すと、JavaScript SDK (api.checkBusinessDay()) で 実際のAPIレスポンス をその場で取得します。result が true なら土日・祝日 (振替休日を含む)、false なら平日です。

🔧 エンジニアの方へ

curl で 3 秒で叩いて、手応えを確認できます。YOUR_API_KEY の部分を、自分のキーに置き換えてください。

curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/holidays?year=2026"

↓ レスポンス (祝日の日付と名称が緑で返ってくれば成功)

{
  "version": "2026-04-01",
  "data": [
    { "date": "2026-01-01", "title": "元日" },
    { "date": "2026-01-12", "title": "成人の日" },
    { "date": "2026-02-11", "title": "建国記念の日" }
  ]
}

🧰SDK公式JavaScript SDK 📄OpenAPI 仕様書技術仕様ページで配布 📚技術仕様 (詳細)エンドポイント・フィールド全網羅

ユースケース

日本の祝日APIが効く代表的なシーン。さらに詳しくはユースケース一覧へ。

日付・スケジュール

予約サイトの祝日自動ブロック

祝日をAPIで取得して予約枠を自動で閉じる。店舗側の手動設定と当日キャンセル対応が減る。

日付・スケジュール

配送日・お届け日の計算

購入画面で土日＋祝日を除いた最短お届け日を表示。休業日を除外したカレンダーをそのまま組める。

日付・スケジュール

決済期日・締日の繰り下げ

請求書の支払期日が休日に当たる場合の翌営業日繰り下げを自動化。会計・経理の締め処理に。

物流オペ

N営業日後の出荷計算

振替休日・国民の休日も考慮した営業日ベースの出荷・納期計算の基盤データに。

運用・インフラ

予約・勤怠のカレンダーUI

予約システム・スケジューラ・勤怠管理に祝日をマーキング。曜日付き出力で実装が楽。

日付・スケジュール

お届け日選択肢の自動生成

「最短3営業日後から」のお届け希望日を、振替休日まで考慮して自動計算。祝日マスタを毎年手更新する作業がなくなる。

日付・スケジュール

配送日・支払期日の自動算出

「N営業日後」の配送日・支払期日を、土日祝を考慮して自動計算。日付ロジックを自前実装しない。

日付・スケジュール

サポートSLA期限の算出

「3営業日以内に一次回答」の期限を自動セット。GWや年末年始でも期限が自動でずれ、SLA超過の見落としが減る。

日付・スケジュール

N営業日後の配送日表示

注文確定時に「3営業日後にお届け」を算出。土日・祝日・振替を自動スキップして最短日を表示。

物流オペ

集荷可能日カレンダー

集荷依頼画面で「営業日のみ」を選択可能に。休業日の誤集荷を防ぐ。

運用・インフラ

スケジューラの休日除外

予約システム・勤怠で土日祝を非営業日として自動グレーアウト。シフト・休日勤務手当の判定にも。

なぜケンオールの日本の祝日APIか

ISMS (ISO/IEC 27001) 認証取得。法人運営でガバナンス・監査要件をクリア、金融・基幹システムにも組み込めます。
契約SLA・障害通知に対応。status.kenall.jp で稼働率をリアルタイム公開、エンタープライズ契約あり。
内閣府公式の祝日定義に準拠。官報追従で自動更新、政府発表に応じて即時反映。
過去・未来の祝日も取得可能。指定年で柔軟に取得でき、長期スケジューラやカレンダーの基礎データに最適。
振替休日・国民の休日にも対応。祝日法に基づく正確な判定で、業務系システムに安心して組み込めます。
周辺APIも1社で完結。営業日計算・郵便番号・住所正規化・法人番号まで同じプラットフォームで取得できます。
商用利用OK・追加許諾不要。フリープランを含むすべてのプランで商用利用可能。
サポート窓口あり。法人運営でメール窓口・契約問い合わせ・障害対応に対応します。

クイックスタート

アカウント登録 → APIキー取得とコピー → あなたの環境で動かす、の3ステップです。キーの取得までは人間の作業、最後の組み込みはAIに任せることもできます(所要約5分)。

Step 1 — アカウント登録

無料で始めるからメールアドレスを登録し、確認メールのリンクをクリック。フリープランは無料・クレジットカード登録不要で始められます。

Step 2 — APIキー取得とコピー

ログイン後、ダッシュボードの左メニュー「APIキー」を開くと、下のような画面になります。やることは ① キーをコピー と、ブラウザから直接使う場合は ② 許可ドメインを登録 の2つだけです。

ケンオールホーム　ドキュメント　料金表　ログアウト

APIキーの管理

名前APIキー有効期限許可ドメイン

公開00000000…12999/12/31www.example.com2

1APIキー: 赤い欄をクリックでコピー。これが次の手順の YOUR_API_KEY です。
2ドメインとポート番号を登録 (ブラウザから直接呼ぶ場合のみ必要)。

注意

APIキーは利用規約に従って適切に管理してください。ブラウザから呼び出す公開キーは許可ドメイン (Origin) を設定し、サーバー用のシークレットキーは第三者に公開しないでください。詳しくは APIキー・認証をご覧ください。

Step 3 — あなたの環境で動かす (AIにコピペ)

使い慣れたAIに 完成形のプロンプト を渡して、自社サイト・アプリ・手元のPC など あなたの環境で動くコード を書いてもらいます。3ステップで完了します。

下のボタンでプロンプトをコピー
ChatGPT / Claude などに貼り付け
末尾をあなたの状況に書き換えて送信

ボタンを押すと、正しい呼び出し方・つまずきポイント・テンプレートまで全部入りのプロンプトがクリップボードにコピーされます。

コピーされる内容 (プレビュー)

あなたはケンオールAPI (日本の公的データAPI / kenall.jp) の実装パートナーです。
このプロンプトの最後にある「私のやりたいこと」を、以下の仕様に従って実装する動くコードを書いてください。

# 使うAPI: 日本の祝日
- エンドポイント: GET https://api.kenall.jp/v1/holidays?year={年}
- 認証: HTTPヘッダ「Authorization: Token YOUR_API_KEY」
- 公式SDK (JavaScript): npm install @ken-all/kenall
- ドキュメント: https://kenall.jp/api/holidays

# 正しい呼び方 (JavaScript SDK・最小コード)
import { KENALL } from "@ken-all/kenall";
const api = new KENALL("★ここに自分のAPIキーを貼り付け★"); // ← ユーザーが書き換える唯一の場所
const json = await api.getHolidays({ year: 2026 });
json.data.forEach(h => console.log(h.date + " " + h.title)); // ← 祝日名は title フィールド (name ではない)

# 本番運用では上の "★...★" の部分を process.env.KENALL_API_KEY などの環境変数に置き換えることを推奨してください (フロントエンドにキーをハードコーディングしない)。

# 必ず守ってほしい実装ルール
1. year は数値または文字列で指定 (省略時は現在年)
2. ブラウザから直接呼ぶ場合は、APIキー側に呼び出し元ドメイン (Origin) が登録されていることが前提
3. APIキーは環境変数で管理
4. TypeScript の場合は型を付ける
5. エラーはユーザーに分かる形でハンドリング

# あなた (AI) の出力ルール【重要】
- コード内で「ユーザー (私) が自分で書き換える場所」は、必ず ★ で囲んで明示してください。
- 実装コードの後に、必ず「## 🔑 あなたが今からやること」という見出しを付けて、ユーザーが行う作業の番号付きチェックリストを出力してください。
  最低でも次の項目を含めてください:
    1. ケンオール管理画面でAPIキーを取得する ( https://kenall.jp/signup )
    2. ★マークの場所を実際の値で置き換える
    3. ブラウザから直接呼ぶ場合は、APIキー側に呼び出し元ドメインを許可登録する
    4. 必要な依存パッケージのインストールコマンド (例: npm install @ken-all/kenall)
    5. 動作確認の手順

# 進め方
1. 私の状況 (下の「私の入力」セクション) を読み、不明点があれば1つだけ質問してください
2. 実装コード (書き換え箇所は ★...★ で必ず明示)
3. 「## 🔑 あなたが今からやること」チェックリスト

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚨 ここから下は「私 (ユーザー) が書き換える唯一の場所」です。
   ★...★ で囲まれた部分を、自分の値に置き換えてください。
   ここから上は、AIへの仕様なので変更しないでください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 📌 私が実施したこと
- [x] ケンオールでAPIキーを取得しました

## 🔑 私のAPIキー
**★ここに自分のAPIキーを貼り付け★**
(ケンオール管理画面 https://kenall.jp/signup の「APIキー」欄でコピーしたもの。「★」も含めて丸ごと書き換えてください)

## 🛠 私の開発状況 (下の4行を自分の状況に書き換え)
- **開発環境**: ★React + Next.js★
- **組み込む場所**: ★社内カレンダー / 業務スケジューラ★
- **やりたいこと**: ★今年と来年の祝日を表示し、振替休日も色分けして表示★
- **呼び出し元ドメイン**: ★http://localhost:8000★ (ブラウザから直接呼ぶ場合のみ。本番のドメインが決まっていれば併記。管理画面でAPIキーに許可登録するもの)

## 🎯 あなた (AI) にしてほしいこと
上の私の状況に合わせて、動くコードを書いてください。コード内で私が手作業で値を入れる場所は ★...★ で囲んで明示し、最後に「## 🔑 あなたが今からやること」チェックリストを出力してください。

ヒント

本番組み込み時は、本番ドメインも許可ドメインに追加しておきましょう。

料金プラン

無料のフリープランでまず試して、日本の祝日APIの本番運用はスタンダードプラン (5,500円/月・税込) から。上位のプレミアム・エンタープライズでもご利用いただけます。

FREE

フリープラン

無料

クレジットカード不要
商用利用可
検証・PoC・評価向け

STANDARD

スタンダードプラン

5,500円/月 (税込)

郵便番号→住所 / 住所→郵便番号 (正規化)
市区町村・銀行情報・日本の祝日
土日・祝日判定

PREMIUM

プレミアムプラン

66,000円/月 (税込)

スタンダードの全機能
法人番号 (検索・法人情報・レーダー)
適格請求書発行事業者・学校コード

ENTERPRISE

エンタープライズ

お問い合わせ

プレミアムの全機能
専用サポート窓口・SLA・RTO
障害通知・セキュリティ評価レポート

クレジットカード不要のフリープランでお試し。日本の祝日APIの本番運用はスタンダードプラン (5,500円/月・税込) から。

→ プランと料金を見る

このAPIに関するよくある質問

日本の祝日APIの料金はいくらですか？

日本の祝日APIはスタンダードプラン (5,500円/月・税込) からご利用いただけます。スタンダードプランには郵便番号・住所・銀行情報・日本の祝日・土日・祝日判定が含まれます。法人番号・適格請求書・学校コードも必要ならプレミアムプラン (66,000円/月・税込)、まずはフリープラン (無料・クレカ不要・商用利用可) でお試しいただけます。詳細はプランと料金へ。

無料の祝日APIと何が違いますか？

無料の祝日APIで足りるなら無料勢で十分です。ただし多くは個人運営・無保証で、可用性やSLAが企業の本番要件に届かない場合があります。ケンオールは法人運営で契約SLA・ISMS認証、曜日付きの出力、住所・法人・銀行と一気通貫で使える点が違います。稟議・保証が必要な企業の本番運用に向いています。

振替休日・国民の休日も含まれますか？

はい、通常の祝日と同じ形式で含まれます。titleがそれぞれ「振替休日」「国民の休日」となります。

会社固有の休日 (年末年始・夏季休暇) は取得できますか？

本APIは祝日法に基づく祝日のみを返します。会社固有の休日は自社カレンダーで別途扱ってください。

商用利用は可能ですか？

はい、無料のフリープランを含めすべてのプランで商用利用が可能です。追加の許諾申請は不要です。

🤝 土日・祝日判定は本APIに同梱

「N営業日後の出荷予定日」「振替休日対応の営業日カウント」など業務系の基幹計算は、本APIに含まれる土日・祝日判定でそのまま実装できます。日本の祝日も土日・祝日判定もスタンダードプラン (5,500円/月・税込) に含まれます。
→ 営業日API リファレンスを見る

今すぐ始める

クレジットカード不要・無料のフリープランあり。ISMS認証取得・法人運営で安心。

無料で始める技術仕様 (詳細)お問い合わせ

最終更新: 2026-06-03

日本の祝日API — その年の祝日、まとめて返す。

このAPIで出来ること (デモンストレーション)

土日・祝日判定 (このプランに含まれます)

🔧 エンジニアの方へ

ユースケース

予約サイトの祝日自動ブロック

配送日・お届け日の計算

決済期日・締日の繰り下げ

N営業日後の出荷計算

予約・勤怠のカレンダーUI

お届け日選択肢の自動生成

配送日・支払期日の自動算出

サポートSLA期限の算出

N営業日後の配送日表示

集荷可能日カレンダー

スケジューラの休日除外

なぜケンオールの日本の祝日APIか

クイックスタート

Step 1 — アカウント登録

Step 2 — APIキー取得とコピー

Step 3 — あなたの環境で動かす (AIにコピペ)

料金プラン

フリープラン

スタンダードプラン

プレミアムプラン

エンタープライズ

このAPIに関するよくある質問

他のAPIと組み合わせて使えますか？

今すぐ始める