Dates & Calendars API

First request

curl --request GET \
  --url "https://api.narwhalapi.com/v1/calendars/holidays/IDN/next?from_date=2026-08-01" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

Example response Illustrative response · not a live request

{
  "country": "IDN",
  "coverage": [
    {
      "scope": "collective_leave",
      "subdivision_codes": []
    },
    {
      "scope": "national_public",
      "subdivision_codes": []
    }
  ],
  "holiday": {
    "date": "2026-08-17",
    "name": "Independence Day",
    "local_name": "Proklamasi Kemerdekaan",
    "subdivision_codes": [],
    "scope": "national_public"
  }
}

Endpoints

Holiday API

GETList a published holiday year./v1/calendars/holidays/{country}/{year}

API reference →

GETFind holidays on a date./v1/calendars/holidays/{country}/on/{date}

API reference →

GETFind the next holiday./v1/calendars/holidays/{country}/next

API reference →

Economic calendar API

GETList releases in a date window./v1/economics/calendar

API reference →

GETRead a release, optionally selecting version_id./v1/economics/calendar/{release_id}

API reference →

Holiday and economic calendar feeds

POSTCreate a subscription using your Narwhal API key and receive its ICS feed URL once./v1/calendars/subscriptions

API reference →

GETFetch the ICS feed./v1/calendars/subscriptions/{token}.ics

API reference →

DELETERevoke a subscription./v1/calendars/subscriptions/{subscription_id}

API reference →

Sources and methodology

Published holidays

Official calendars retain national and regional scope, observed dates, and source definitions.

Read the methodology →

Release schedules

Economic releases retain their reference period, publication status, timezone, and schedule precision.

Calendar subscriptions

Revocable ICS feeds deliver selected events. Calendar clients control refresh timing.

Coverage

View coverage →

Holiday coverage is published by country and year. Release schedules may specify an exact time, a date, a range, or a deadline. Public holidays do not establish bank or exchange closure.