특정 날짜의 공휴일
현지 민간 달력 날짜 하나의 게시된 모든 공휴일을 조회합니다.
요청
Narwhal 키로 게시된 국가 연도에 사용할 수 있습니다. 범위와 적용 대상 확인 날짜를 요청하기 전에.
GET /v1/calendars/holidays/{country}/on/{date}curl "https://api.narwhalapi.com/v1/calendars/holidays/IDN/on/2026-08-17" \
-H "Authorization: Bearer $NARWHAL_API_KEY"매개변수
| 이름 | 유형 | 규칙 |
|---|---|---|
country | 문자열 | 필수 경로 값입니다. IDN과 같은 지원되는 대문자 ISO alpha-3 코드 하나입니다. |
date | 날짜 문자열 | 필수 경로 값 YYYY-MM-DD이며 연도는 1900~2200입니다. |
scope | 문자열 | 선택적 쿼리 필터입니다: national_public, regional_public, bank, federal_government, central_government, collective_leave, public_sector 또는 private_sector. 게시된 모든 범주를 반환하려면 생략하세요. |
하위 지역 필터나 페이지 매김이 없습니다. MCP 입력 객체는 추가 필드를 거부합니다.
예시 응답
{
"country": "IDN",
"date": "2026-08-17",
"coverage": [
{
"scope": "national_public",
"nationwide": true,
"subdivision_codes": []
},
{
"scope": "collective_leave",
"nationwide": true,
"subdivision_codes": []
}
],
"holidays": [
{
"date": "2026-08-17",
"name": "Independence Day",
"local_name": "Hari Kemerdekaan",
"subdivision_codes": [],
"nationwide": true,
"observed": null,
"scope": "national_public"
}
]
}일치하는 모든 이벤트를 반환합니다. 빈 holidays 배열은 완전하게 게시된 연도 안에서 일치하는 이벤트가 없다는 뜻이며 은행이나 거래소가 열려 있다는 증거는 아닙니다. 연도 데이터 범위가 없으면 503을 반환합니다.
공유 공휴일 필드 모든 이벤트에는 국가 또는 지역 적용 범위가 명시되어 있습니다.
대응하는 MCP 호출
인증된 요청 전송 POST /mcp 다음과 함께 Accept: application/json, text/event-stream.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendars_get_holidays_on_date",
"arguments": {
"country": "IDN",
"date": "2026-08-17"
}
}
}성공한 결과에는 다음이 있습니다 isError: false, 동일한 응답을 structuredContent, 그리고 직렬화된 JSON으로 content[0].text 도메인 오류에는 다음이 있습니다: isError: true.
오류 및 할당량
잘못된 입력은 400을 반환하고, 누락되었거나 잘못된 키는 401을 반환합니다. 연결되지 않은 경로는 404를 반환합니다. 속도 또는 할당량 소진은 429를 반환합니다. 누락·잘못되었거나 철회된 달력은 다음을 반환합니다 503 calendar_coverage_unavailable.
성공한 호출 하나는 이벤트 수나 조회 연도와 관계없이 월간 요청 1회를 소비합니다. 오류는 월간 할당량을 소비하지 않습니다. 공유 오류 세부 정보.