祝日 API リファレンス

公開ベータ版（提供中）

以下の公開済み国・年には Narwhal APIキーを使用します。REST と MCP は同じカバレッジとクォータを共有します。カバレッジ欠損時は明示的なエラーを返し、例は参考用のままです。

3つの操作

リファレンス	GET エンドポイント	MCPツール
祝日を一覧表示	`/v1/calendars/holidays/{country}/{year}`	`calendars_list_holidays`
指定日の祝日	`/v1/calendars/holidays/{country}/on/{date}`	`calendars_get_holidays_on_date`
次の祝日	`/v1/calendars/holidays/{country}/next?from_date={from_date}`	`calendars_get_next_holiday`

次のような大文字の国コードを使用します： IDN 。現地の暦日を指定する形式は YYYY-MM-DD です。country と date/year のパラメータは必須です。任意の scope フィルターで祝日カテゴリを選択できます。ページ分割や行政区分によるフィルターはありません。

共有休日オブジェクト

フィールド	種別	意味
`date`	日付文字列	ローカルカレンダーの日付であり、取り込みタイムスタンプではありません。
`name`	文字列	英語表示名、1～256文字。
`local_name`	文字列	現地名がある場合は1–256文字で返します。ない場合は省略します。
`subdivision_codes`	文字列配列	GB-SCT など、その国の行政区画を示すコードを重複なくソートした配列です。空の配列は全国対象を意味します。
`scope`	文字列	national_public、bank、federal_government、collective_leave などの休日カテゴリ。
`observed`	ブール値	振替休日・代休日に該当するかを明示します。不明な場合は省略します。不明は false を意味しません。

休日オブジェクトには常に date、name、scope、subdivision_codes が含まれます。各レスポンスには、日付の検索結果が空の場合も、scope と subdivision_codes を含む対象範囲の情報が含まれます。リクエスト ID とクォータはヘッダーに含まれます。成功レスポンスの本文には、ソース URL や取り込み確認時刻は含まれません。

カバレッジと制限

公開 API のカバレッジ · 利用可能と記載されていない国や年は、カバレッジなしとして返されます。
国	2026	2027	公開範囲
`ARG`	利用可能	まだ利用できません	国民の祝日
`AUS`	利用可能	利用可能	ニューサウスウェールズ州のみ：地域の祝日と銀行休業日
`AUT`	利用可能	利用可能	国民の祝日
`BEL`	利用可能	利用可能	国民の祝日
`BRA`	利用可能	まだ利用できません	連邦政府の祝日。任意の休業日と一部休業は対象外
`CAN`	利用可能	利用可能	連邦規制対象の民間雇用主に適用される全国的な法定基準です。州および連邦公務員の休日は含みません。
`CHN`	利用可能	まだ利用できません	全国的な連休。振替出勤日は対象外
`COL`	利用可能	利用可能	国民の祝日
`CZE`	利用可能	利用可能	全国の祝日。重要記念日、通常の日曜日、雇用主による休業日は対象外
`DEU`	利用可能	まだ利用できません	全国共通の祝日。州独自の祝日は含みません
`DNK`	利用可能	利用可能	Danmarks Nationalbank の休業日。一般的な就業上の休日カレンダーではありません
`ESP`	利用可能	まだ利用できません	国民の祝日
`EST`	利用可能	利用可能	全国の祝日と休日。国の重要記念日と労働時間が短縮される日は対象外
`FRA`	利用可能	利用可能	全国共通の法定祝日。地域独自の追加祝日は対象外
`GBR`	利用可能	利用可能	イングランド・ウェールズ、スコットランド、北アイルランドの銀行休業日
`HKG`	利用可能	利用可能	香港の一般休日。通常の日曜日は除外
`HRV`	利用可能	利用可能	国の祝日と非勤務日。記念日と宗派別の日は除外
`IDN`	利用可能	利用可能	国民の祝日と一斉休暇を個別に表示
`IND`	まだ利用できません	まだ利用できません	ソースを確認中
`IRL`	利用可能	利用可能	全国の祝日。雇用主独自の代替措置と休暇取得権は対象外
`ITA`	利用可能	利用可能	全国の法定祝日。地域や雇用主独自の休業日は含みません
`JPN`	利用可能	利用可能	国民の祝日
`KOR`	まだ利用できません	まだ利用できません	ソースを確認中
`LTU`	利用可能	利用可能	労働法第123条に基づく全国祝日。地域行事は除外
`LUX`	利用可能	利用可能	国民の祝日
`LVA`	利用可能	利用可能	全国の祝日。記念日と地域行事は対象外
`MEX`	利用可能	利用可能	全国一律の法定休日。銀行、州・自治体限定、業種別の休業日は対象外
`NLD`	利用可能	利用可能	全国の祝日（休暇は雇用条件による）
`NOR`	利用可能	まだ利用できません	Norges Bank の決済システム休業日。一般的な就業上の休日カレンダーではありません
`NZL`	利用可能	利用可能	全国の祝日と振替日（地域の記念日を除く）
`PHL`	まだ利用できません	まだ利用できません	ソースを確認中
`POL`	利用可能	利用可能	全国の祝日。通常の日曜日、地域行事、雇用主による休業日は対象外
`PRT`	利用可能	利用可能	国の法定祝日。任意、自治体、地域の祝日は除外
`RUS`	まだ利用できません	まだ利用できません	ソースを確認中
`SAU`	まだ利用できません	まだ利用できません	ソースを確認中
`SGP`	利用可能	利用可能	国の祝日と出典指定の振替日
`SVK`	利用可能	利用可能	国民の祝日
`SVN`	利用可能	利用可能	国の祝日と休業日。休業日でない記念日と地域の祝日は除外
`SWE`	利用可能	利用可能	国民の祝日
`TUR`	まだ利用できません	まだ利用できません	ソースを確認中
`TWN`	利用可能	利用可能	政府機関のカレンダー。民間部門と市場の休場日は除外しています。
`USA`	利用可能	利用可能	連邦職員の休日と振替日。州の休日は除外
`ZAF`	利用可能	利用可能	国民の祝日。学校のみの休日は除外

利用可能な項目は記載された範囲だけを示し、すべての地域や業種の休日を網羅しません。入力は1900～2200年を許可しますが、過去のデータの提供を保証するものではありません。

公開済みの年には1～400件のイベントが含まれます。指定された国と年のカレンダーが公開されていない場合は 404 calendar_not_published、現在安全に提供できないカレンダーは 503 calendar_coverage_unavailableです。日付検索で空の配列を返せるのは、その年のデータが公開済みの場合だけです。祝日データは銀行や取引所の休業を保証するものではありません。

年、日付、または範囲がプランの履歴対象期間（Freeは12か月、Basicは5年、Proは全期間）より前の場合は403 plan_upgrade_requiredを返します。

成功した呼び出しは、日付の結果が空の場合も含め、共有月間リクエストを1件消費します。エラーは月間クォータを消費しませんが、短時間のレート制限は適用されます。共通のエラーとクォータの仕様を確認。