---
title: "공휴일/휴일 다건 조회 (Get holidays)"
method: GET
path: "/v2/holidays"
tags: ["공휴일/휴일 (holidays)"]
---

# 공휴일/휴일 다건 조회 (Get holidays)

`GET /v2/holidays`

회사의 휴일 그룹별 휴일 목록을 조회합니다. 법정공휴일(대체공휴일 포함)과 회사 자체 휴일이 함께 반환됩니다.

## Query parameters

- `from` string, date, required
- `to` string, date, required

## Response `200`

OK

- HolidayGroupListResponse
  - `holidayGroups` HolidayGroupDto[], required — 휴일 그룹 목록
    - `countryCode` string, required — 휴일 그룹 적용 국가 (ISO 3166-1 alpha-2). 내부 시스템이 한국 단일 국가 가정으로 구현되어 현재는 `KR` 고정. 다국가 지원 시 동적 노출 예정.
    - `groupName` string, required — 휴일 그룹 이름
    - `holidays` HolidayDto[], required — 기간 내 휴일 목록 (날짜 오름차순)
      - `date` string, date, required — 휴일 날짜
      - `name` string, required — 휴일 이름
      - `type` 'PUBLIC_HOLIDAY' | 'CUSTOM_HOLIDAY', required — 휴일 타입. PUBLIC_HOLIDAY: 법정공휴일(대체공휴일 포함), CUSTOM_HOLIDAY: 회사 자체 휴일(창립기념일 등)

---

[API](https://skmtc.dev/flex/apis/flex-open-api.md) · [All operations](https://skmtc.dev/flex/apis/flex-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flex/flex-open-api/revisions/1fcc64732f19/schema)