三个实用查询
为代理的回答标注报告、显示即将到来的假日，并添加当地日期背景。
阅读方法说明 →所有 API
公开 假日日历 API
按国家、年份及日期查询已发布的公共假期。
首次请求
快速入门 →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"
}
}端点
来源与方法论
国家和地区范围
了解某个事件适用于全国，还是仅适用于列出的行政区。
可供你检查的覆盖范围
日历参考列出了已发布年份及其确切作用域。随着十九国目标扩展，其他国家和年份仍会明确标为不可用。
覆盖范围
查看覆盖范围 →公共假日不代表银行、交易所或结算系统关闭。地区事件仍会显示，实际放假状态可能未知；日历覆盖缺失时会返回错误，而不是猜测日期。