すべてのAPI

祝日API

REST または MCP で国と年ごとの祝日を取得します。日付を確認したり、国および地域の範囲で次の祝日を検索できます。

最初のリクエスト

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"
  }
}

カレンダー購読

Narwhal API で、チームが選んだ国と日付範囲の購読用 ICS フィードを作成できます。提供されている祝日、経済指標の発表日、またはその両方を含められます。Google カレンダー、Apple カレンダー、Outlook などのカレンダークライアントで利用できます。

curl --request POST \
  --url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
  --header "Authorization: Bearer $NARWHAL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'

レスポンスの例説明用レスポンス · 実際のリクエストによるものではありません

{
  "subscription_id": "example-subscription",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2026-12-31T23:59:59Z",
  "refresh_note": "calendar clients control refresh latency"
}