모든 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 Calendar, Apple Calendar, 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"
}