カレンダーAPIリファレンス
REST と MCP による年間祝日、日付検索、次の祝日リクエスト。
ライブ公開ベータ版
以下の公開済み国・年には 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 フォーム。国と日付／年のパラメータは必須です。任意の範囲フィルターで休日カテゴリを選択できます。ページ分割や下位区分フィルターはありません。
共有休日オブジェクト
| フィールド | 種別 | 意味 |
|---|---|---|
date | 日付文字列 | ローカルカレンダーの日付であり、取り込みタイムスタンプではありません。 |
name | 文字列 | 英語表示名、1～256文字。 |
local_name | 文字列または null | 利用可能な場合の現地名、1～256文字。 |
subdivision_codes | 文字列配列 | GB-SCT など、国に属する重複のないソート済みコード。 |
nationwide | ブール値 | true には空の下位区分リストが必要で、false には空でないリストが必要です。 |
scope | 文字列 | national_public、bank、federal_government、collective_leave などの休日カテゴリ。 |
observed | ブール値または null | 観測値か代替値かを明示するステータス。null は不明を意味し、false ではありません。 |
通常の休日オブジェクトには7つのフィールドすべてが含まれます。各レスポンスには、日付の結果が空の場合も含め、scope、nationwide、subdivision_codes を含むカバレッジ宣言も含まれます。リクエスト ID とクォータはヘッダーに残ります。ソース URL と取り込み確認時刻は成功レスポンスの本文に含まれません。
カバレッジと制限
| 国 | 2026 | 2027 | 公開範囲 |
|---|---|---|---|
ARG | まだ利用できません | まだ利用できません | ソースを確認中 |
AUS | 利用可能 | 利用可能 | ニューサウスウェールズ州のみ：地域の祝日と銀行休業日 |
BRA | まだ利用できません | まだ利用できません | ソースを確認中 |
CAN | まだ利用できません | まだ利用できません | ソースを確認中 |
CHN | 利用可能 | まだ利用できません | 国の休日。振替出勤日は除外 |
FRA | 利用可能 | 利用可能 | 一般的な国の法定休日。地域の追加分は除外。 |
DEU | まだ利用できません | まだ利用できません | ソースを確認中 |
IND | まだ利用できません | まだ利用できません | ソースを確認中 |
IDN | 利用可能 | まだ利用できません | 国民の祝日と一斉休暇を個別に表示 |
ITA | まだ利用できません | まだ利用できません | ソースを確認中 |
JPN | 利用可能 | 利用可能 | 国民の祝日 |
MEX | まだ利用できません | まだ利用できません | ソースを確認中 |
KOR | まだ利用できません | まだ利用できません | ソースを確認中 |
RUS | まだ利用できません | まだ利用できません | ソースを確認中 |
SAU | まだ利用できません | まだ利用できません | ソースを確認中 |
ZAF | まだ利用できません | 利用可能 | 国民の祝日。学校のみの休日は除外 |
TUR | まだ利用できません | まだ利用できません | ソースを確認中 |
GBR | 利用可能 | 利用可能 | イングランド・ウェールズ、スコットランド、北アイルランドの銀行休業日 |
USA | 利用可能 | 利用可能 | 連邦職員の休日と振替日。州の休日は除外 |
対象は引き続き19か国です。利用可能な項目は記載された範囲だけを示し、すべての地域や業種の休日を示すものではありません。年の検証では1900～2200を許可しますが、これは履歴のカバレッジを主張するものではありません。
公開済みの年には1～400件のイベントが含まれます。欠落または撤回されたカバレッジは 503 calendar_coverage_unavailable。日付検索が空の配列を返せるのは、その年が公開済みの場合だけです。祝日は銀行や取引所の休業を証明するものではありません。
成功した呼び出しは、日付の結果が空の場合も含め、共有月間リクエストを1件消費します。エラーは月間クォータを消費しませんが、短時間のレート制限は適用されます。 共有エラーとクォータの契約を読む.