세 가지 유용한 조회
보고서에 주석을 달고, 예정된 공휴일을 표시하며, 에이전트의 답변에 현지 날짜 맥락을 추가하십시오.
방법론 읽기 →모든 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"
}
}엔드포인트
GET발표 연도 나열/v1/calendars/holidays/{country}/{year}
GET날짜 확인/v1/calendars/holidays/{country}/on/{date}
GET다음 공휴일 찾기/v1/calendars/holidays/{country}/next
출처 및 방법론
국가 및 지역 범위
행사가 전국에 적용되는지 명시된 하위 지역에만 적용되는지 확인하세요.
확인할 수 있는 데이터 범위
게시된 연도와 정확한 범위는 달력 레퍼런스에 나열되어 있습니다. 19개 국가 목표가 확대되는 동안 다른 국가와 연도는 명시적으로 이용할 수 없는 상태로 유지됩니다.
데이터 범위
데이터 범위 보기 →공휴일이 은행, 거래소 또는 결제 시장의 휴장을 의미하지는 않습니다. 지역 행사는 계속 표시되고 대체 휴일 상태는 알 수 없을 수 있으며, 달력 데이터가 누락되면 추측한 날짜 대신 오류가 반환됩니다.