---
title: "사번으로 구성원 연차 부여 목록 조회 (Get user annual time-off users by employee numbers)"
method: GET
path: "/v2/users/time-off-buckets/annual"
tags: ["구성원 휴가 부여 (user-time-off-buckets)"]
---

# 사번으로 구성원 연차 부여 목록 조회 (Get user annual time-off users by employee numbers)

`GET /v2/users/time-off-buckets/annual`

구성원들의 연차 부여 목록을 조회합니다.

## Query parameters

- `employeeNumbers` string[], required

## Response `200`

OK

- UserAnnualTimeOffBucketListResponse
  - `userAnnualTimeOffBuckets` UserAnnualTimeOffBucketListDto[], required — 각 구성원들의 연차 부여 목록
    - `employeeNumber` string, required — 구성원의 사원번호
    - `buckets` AnnualTimeOffBucketDto[], required — 해당 구성원의 연차단위정보 목록
      - `assignedDate` string, date, required — 연차가 부여된 날짜
      - `assignedMinutes` integer, required — 부여된 연차 시간 (분)
      - `usedMinutes` integer, required — 부여된 시간 중 사용한 시간 (분)
      - `validUsageDateRange` DateRangeDto, required — 부여된 연차의 사용 날짜 범위
        - `from` string, date, required — 날짜 범위 중 시작 날짜
        - `to` string, date, required — 날짜 범위 중 종료 날짜
    - `uses` AnnualTimeOffUseDto[], required — 해당 구성원의 연차사용 목록
      - `usedDate` string, date, required — 사용된 날짜
      - `usedMinutes` integer, required — 사용된 연차 시간 (분)
    - `adjusts` AnnualTimeOffAdjustDto[], required — 해당 구성원의 연차조정 목록
      - `adjustedDate` string, date, required — 조정된 날짜
      - `adjustedMinutes` integer, required — 조정된 연차 시간 (분)
    - `assigns` AnnualTimeOffAssignDto[], required — 해당 구성원의 연차부여 목록
      - `assignedDate` string, date, required — 연차 부여된 날짜
      - `assignedMinutes` integer, required — 연차 부여된 시간 (분)
      - `validUsageDateRange` DateRange, required — 연차 사용 날짜 범위
        - `from` string, date, required
        - `to` string, date, required
        - `dateCount` integer, required
        - `valid` boolean, required
    - `remainingTimeOff` AnnualTimeOffRemainingTimeOffDto, required — 해당 구성원의 잔여연차 정보
      - `remainingTimeOffByMinute` integer, required — 잔여 연차 시간 (분)
      - `remainingTimeOffByDay` number, required — 잔여 연차(일)

---

[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)