祝日オープンデータ：JSONとICS

URL（固定・バージョン1）

すべて静的ファイルで、1日キャッシュされます。国コードはISO 3166-1 alpha-2（小文字）、地域コードは国の接頭辞を除いたISO 3166-2です。

https://toolboxday.com/data/v1/holidays/index.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.ics

index.json · /data/v1/holidays/de/2027.json · /data/v1/holidays/fr/2027.ics

{
  "date": "2027-01-06",
  "id": "heiligeDreiKoenige",
  "name": "Epiphany",
  "localName": "Heilige Drei Könige",
  "nationwide": false,
  "regions": [
    "BW",
    "BY",
    "ST"
  ]
}

サンプルコード

JavaScript

const res = await fetch('https://toolboxday.com/data/v1/holidays/de/2027.json');
const data = await res.json();
// nationwide holidays + holidays of one state (e.g. Bavaria = "BY")
const byState = data.holidays.filter(
  (h) => h.nationwide || h.regions?.includes('BY')
);
console.log(byState.map((h) => `${h.date} ${h.name}`));

Python

import json, urllib.request

url = "https://toolboxday.com/data/v1/holidays/de/2027.json"
data = json.load(urllib.request.urlopen(url))
for h in data["holidays"]:
    where = "nationwide" if h["nationwide"] else ", ".join(h["regions"])
    print(h["date"], h["name"], "-", where)

curl + jq

curl -s https://toolboxday.com/data/v1/holidays/de/2027.json | jq '.holidays[] | select(.nationwide) | .date'

カレンダーに登録する

ICSファイルには全国共通の祝日が含まれます。Googleカレンダーは「他のカレンダー → URLで追加」、Outlookは「予定表を追加 → Webから購読」、iPhoneは「設定 → カレンダー → アカウント → 照会するカレンダーを追加」から登録できます。

https://toolboxday.com/data/v1/holidays/fr/2027.ics

データの確認方法

• ドイツ：16州の祝日法と統一条約から算出し、法令本文に対して自動テストしています。
• その他の国：python-holidaysで生成し、Nager.DateおよびGoogleの公開祝日カレンダーと照合しています。差異のある国・年・地域は含めていません。
• 太陰暦に基づく祝日には「estimated」が付きます。月の観測により日付が1日ずれる場合があります。保証はありません。法的な目的には公式情報を優先してください。

学校休暇

ドイツのJSONファイルには、公式に発表されている範囲で16州の学校休暇（出典：KMKおよび各州文部省）も含まれます。

その他の国の学校休暇（OpenHolidays API）は、Open Database License（ODbL 1.0）の別ファイルで提供しています： /data/schulferien-welt.json

誤りや欠けている国があればご連絡ください： info@saracai.de