An economic calendar
Build a calendar of releases for the countries and dates you choose.
Read the guide →Public holidays, economic release schedules, and subscribed calendars.
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",
"coverage": [
{
"scope": "collective_leave",
"subdivision_codes": []
},
{
"scope": "national_public",
"subdivision_codes": []
}
],
"holiday": {
"date": "2026-08-17",
"name": "Independence Day",
"holiday_key": "independence_day",
"local_name": "Proklamasi Kemerdekaan",
"subdivision_codes": [],
"scope": "national_public"
}
}/v1/calendars/holidays/{country}/{year}List a published holiday year.
countryrequiredThree-letter country code, such as IDN or JPN.
yearrequiredA published year, such as 2026.
scopeoptionalOnly one kind of day: national_public, regional_public, bank, collective_leave and others. Leave it out to get every kind.
datedateThe local calendar date of the holiday.
namestringThe holiday name in English.
holiday_keystringThe same key for the same holiday in every country, such as christmas_day.
local_namestringThe name in the local language, when the government publishes one.
scopestringWhat kind of day it is, such as national_public, bank or collective_leave.
subdivision_codesarrayRegions where it applies, such as GB-SCT. Empty means the whole country.
/v1/calendars/holidays/{country}/on/{date}Find holidays on a date.
countryrequiredThree-letter country code, such as IDN or JPN.
daterequiredThe day to check, as YYYY-MM-DD.
scopeoptionalOnly one kind of day: national_public, regional_public, bank, collective_leave and others. Leave it out to get every kind.
datedateThe local calendar date of the holiday.
namestringThe holiday name in English.
holiday_keystringThe same key for the same holiday in every country, such as christmas_day.
local_namestringThe name in the local language, when the government publishes one.
scopestringWhat kind of day it is, such as national_public, bank or collective_leave.
subdivision_codesarrayRegions where it applies, such as GB-SCT. Empty means the whole country.
/v1/calendars/holidays/{country}/nextFind the next holiday.
countryrequiredThree-letter country code, such as IDN or JPN.
from_daterequiredStart from this day, as YYYY-MM-DD. The day itself counts.
scopeoptionalOnly one kind of day: national_public, regional_public, bank, collective_leave and others. Leave it out to get every kind.
datedateThe local calendar date of the holiday.
namestringThe holiday name in English.
holiday_keystringThe same key for the same holiday in every country, such as christmas_day.
local_namestringThe name in the local language, when the government publishes one.
scopestringWhat kind of day it is, such as national_public, bank or collective_leave.
subdivision_codesarrayRegions where it applies, such as GB-SCT. Empty means the whole country.
/v1/economics/calendarList releases in a date window.
countriesoptionalISO alpha-3 codes, such as USA. Repeat the parameter for several countries, at most 50.
start_dateoptionalFirst day of the window. The window starts 30 days before today by default.
end_dateoptionalLast day of the window. It ends 335 days after today by default. The window spans at most 366 days.
limitoptionalReleases per page, 1 to 100. The default is 100.
cursoroptionalContinue with next_cursor and the same filters.
release_idstringThe release to read in detail.
namestringNarwhal’s standard English name, such as Producer prices. It contains no dates.
topicstringWhat the series measures, the same in every country, such as consumer_prices or gdp.
periodstringThe period the release covers, such as 2026-09 or 2026-Q3.
statusstringWhere the release stands, such as scheduled.
at / date / between / bystringThe timing the publisher gave: an exact time, a day, a range of days or a deadline. None appears when the date is unknown.
valuesarrayThe published figures. The array is empty until they are out.
/v1/economics/calendar/{release_id}Read a release, optionally selecting version_id.
release_idrequiredThe release’s UUID.
version_idoptionalThe UUID of an earlier version. Without it you get the current one.
versionstringThe immutable version, which you can pass back as version_id.
namestringNarwhal’s standard English name, such as Producer prices. It contains no dates.
topicstringWhat the series measures, the same in every country, such as consumer_prices or gdp.
periodstringThe period the release covers, such as 2026-09 or 2026-Q3.
statusstringWhere the release stands, such as scheduled.
at / date / between / bystringThe timing the publisher gave: an exact time, a day, a range of days or a deadline. None appears when the date is unknown.
valuesarrayThe published figures. The array is empty until they are out.
/v1/calendars/subscriptions/v1/calendars/subscriptions/{token}.ics/v1/calendars/subscriptions/{subscription_id}Build a calendar of releases for the countries and dates you choose.
Read the guide →Find when the next US CPI is due, in UTC and New York time.
Read the guide →Get a reminder before a release from a calendar feed or a daily script.
Read the guide →Count the working days in a pay period or a leave request.
Read the guide →See which days each office is closed before you plan a release or a meeting.
Read the guide →Get a yes or no for one date, with regional and observed days handled.
Read the guide →Find the settlement date of a trade around weekends and market holidays.
Read the use case →Know which public holidays apply to staff in each country.
Read the use case →Release dates and status for GDP, prices, labour, trade and yield curves.
Explore the API →Official public holidays by country, with national and regional scope.
Explore the API →$10 of free credit a month, then from $2 per 1,000 calls.
See pricing →Create a calendar subscription to receive a revocable ICS feed for public holidays, economic releases, or both.
No. The schedule preserves the publisher’s precision instead of assigning an invented time.
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.
$10 of free credit every month for 12 months. No card needed.$10 of free credit a month. No card needed.