---
title: "사번으로 기간별 구성원 타각 이벤트 조회"
method: GET
path: "/v2/users/work-clock-events/dates/{beginDate}/{endDate}"
tags: ["구성원 타각 이벤트 (user-work-clock-events)"]
---

# 사번으로 기간별 구성원 타각 이벤트 조회

`GET /v2/users/work-clock-events/dates/{beginDate}/{endDate}`

구성원들의 기간별 타각 이벤트를 최장 31일까지 조회합니다.

## Path parameters

- `beginDate` string, date, required
- `endDate` string, date, required

## Query parameters

- `employeeNumbers` string[], required

## Response `200`

OK

- UserWorkClockEventListResponse
  - `workClockEvents` UserWorkClockEventDto[], required — 각 구성원들의 타각 이벤트 목록
    - `employeeNumber` string, required — 구성원의 사원번호
    - `days` DayWorkClockEventDto[], required — 각 날짜별 타각 이벤트
      - `date` string, date, required — 일별 타각 이벤트의 날짜
      - `events` WorkClockEventDto[], required — 일별 타각 이벤트 목록
        - `eventType` 'START' | 'SWITCH' | 'STOP' | 'REST_START' | 'REST_STOP', required — 타각 이벤트 유형
        - `formName` string, required — 근무/휴게의 정책 이름 (STOP, REST_STOP일 경우 null) 근무 예: 근무, 재택, 외근, 출장
        - `realTime` string, required — 실제 타각 이벤트 시각 (ISO-8601)
        - `targetTime` string, required — 인정 타각 이벤트 시각 (ISO-8601)

---

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