次の祝日
指定した現地暦の日付以降の祝日を1件検索します。
リクエスト
Narwhalキーで公開済みの国・年について利用できます。 カバレッジと範囲を確認 日付をリクエストする前に。
GET /v1/calendars/holidays/{country}/next?from_date={from_date}curl "https://api.narwhalapi.com/v1/calendars/holidays/IDN/next?from_date=2026-08-01" \
-H "Authorization: Bearer $NARWHAL_API_KEY"パラメータ
| 名前 | 種別 | 規則 |
|---|---|---|
country | 文字列 | 必須パス値。IDN など、サポート対象の大文字 ISO alpha-3 コードを1つ指定します。 |
from_date | 日付文字列 | 必須クエリ値 YYYY-MM-DD。年は1900～2200で、今日の日付が自動的に設定されることはありません。 |
scope | 文字列 | 任意のクエリフィルター：national_public、regional_public、bank、federal_government、central_government、collective_leave、public_sector、private_sector。公開済みの全カテゴリを返す場合は省略します。 |
下位区分フィルターやページ分割はありません。MCP 入力オブジェクトは余分なフィールドを拒否します。
説明用レスポンス
{
"country": "IDN",
"from_date": "2026-08-01",
"coverage": [
{
"scope": "national_public",
"nationwide": true,
"subdivision_codes": []
},
{
"scope": "collective_leave",
"nationwide": true,
"subdivision_codes": []
}
],
"holiday": {
"date": "2026-08-17",
"name": "Independence Day",
"local_name": "Hari Kemerdekaan",
"subdivision_codes": [],
"nationwide": true,
"observed": null,
"scope": "national_public"
}
}開始日は包含されます。現在の年を検索し、必要な場合に限り翌年を検索します。必要なカバレッジがない場合は 503 を返します。2200年を超えて検索することはありません。最大年に残りのイベントがない場合は holiday: null を返します。地域の祝日を返す場合があります。複数のイベントが最も早い日付を共有する場合は、安定ソートで先頭のものが選ばれます。すべて取得するには日付エンドポイントを使用してください。
共有休日フィールド。各イベントには、国または地域への適用範囲が明示されます。
対応するMCP呼び出し
認証済みのリクエストを送信： POST /mcp 次を伴う： Accept: application/json, text/event-stream.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendars_get_next_holiday",
"arguments": {
"country": "IDN",
"from_date": "2026-08-01"
}
}
}成功した結果に含まれるもの： isError: false、同じレスポンスを structuredContent、シリアライズされたJSONを content[0].text。ドメインエラーには isError: true.
エラーとクォータ
無効な入力は400、欠落または無効なキーは401を返します。未マウントのルートは404です。レートまたはクォータの枯渇は429を返します。欠落、無効、撤回されたカレンダーは 503 calendar_coverage_unavailable.
成功した呼び出し1回で、イベント数や読み取る年数にかかわらず、月間リクエストを1件消費します。エラーでは月間クォータを消費しません。 共有エラーの詳細.