3つの便利な検索
レポートに注釈を付け、今後の休日を表示し、エージェントの回答に現地の日付情報を追加します。
方法論を読む →すべてのAPI
公開祝日カレンダー API
国・年・日付別の公表済み祝日データ。
初回リクエスト
クイックスタート →curl --request GET \
--url "https://api.narwhalapi.com/v1/calendars/holidays/IDN/next?from_date=2026-08-01" \
--header "Authorization: Bearer $NARWHAL_API_KEY"レスポンスの例 説明用レスポンス · ライブリクエストではありません
{
"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"
}
}エンドポイント
GET公開済みの年を一覧表示/v1/calendars/holidays/{country}/{year}
GET日付を確認/v1/calendars/holidays/{country}/on/{date}
GET次の祝日を検索/v1/calendars/holidays/{country}/next
ソースと方法論
国および地域の範囲
イベントが全国に適用されるのか、指定された地域だけに適用されるのかを確認してください。
確認できるカバレッジ
公開済みの年とその正確な範囲はカレンダーリファレンスに記載されています。19か国の対象が拡大する間も、その他の国と年は明示的に利用できません。
カバレッジ
カバレッジを表示 →公開祝日は、銀行、取引所、決済の休業を定めるものではありません。地域の行事は表示されたままになり、振替ステータスが不明になる場合があります。カレンダーのカバレッジがない場合は、推測した日付ではなくエラーを返します。