Public Holiday Calendar API

Calendars APIAccess not open

api.narwhalapi.com JSON

GET/v1/calendars/holidays/IDN/next?from_date=2026-08-01

{
  "country": "IDN",
  "from_date": "2026-08-01",
  "holiday": {
    "date": "2026-08-17",
    "name": "Independence Day",
    "local_name": "Hari Kemerdekaan",
    "subdivision_codes": [],
    "nationwide": true,
    "observed": null
  }
}

Dates your workflow can interpret

Three useful lookups

Annotate reports, show upcoming holidays, and add local date context to an agent's answer.

National and regional scope

Know whether an event applies nationwide or only to the named subdivisions.

Nineteen-country target

The contract supports the sovereign G20 countries. Each country and year still needs source approval before access opens.

Preview the endpointsv1

GET/v1/calendars/holidays/{country}/{year}

List a published year

Not open

GET/v1/calendars/holidays/{country}/on/{date}

Check a date

Not open

GET/v1/calendars/holidays/{country}/next

Find the next holiday

Not open

REST and MCP share one Narwhal key and quota. Calendar access is not open.

Holiday dates and API docs

Find holiday dates

Read country calendars with dates, weekdays and official sources.

Browse holiday calendars

Integration reference

Exact paths, inputs, response fields and matching MCP calls.

Explore the contracts

Coverage and definitions

Country scope, source review and what these dates mean.

Read the methodology

Plan your calendar integration

Review the contracts while source approval is completed. No launch date or calendar-specific price has been announced.

Read the calendar docs Explore live APIs