三個實用查詢
為代理的回答標注報告、顯示即將到來的假日，並添加當地日期背景。
閱讀方法說明 →所有 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"
}
}端點
來源與方法論
國家和地區範圍
瞭解某個事件適用於全國，還是僅適用於列出的行政區。
可供你檢查的覆蓋範圍
日曆參考列出了已發布年份及其確切作用域。隨著十九國目標擴展，其他國家和年份仍會明確標為不可用。
覆蓋範圍
查看覆蓋範圍 →公共假日不代表銀行、交易所或結算系統關閉。地區事件仍會顯示，實際放假狀態可能未知；日曆覆蓋缺失時會返回錯誤，而不是猜測日期。