v1

구성원 근무 스케줄, 타각 (user-work-schedules-with-work-clock)

사번으로 기간별 구성원 근무 스케줄, 타각 조회

구성원들의 기간별 근무 스케줄을 최장 31일까지 조회합니다. 진행 중인 근무, 휴게도 포함됩니다.

get/v2/users/work-schedules-with-work-clock/dates/{beginDate}/{endDate}

Path parameters

beginDatestring date required

검색할 근무 스케줄 시작일 / YYYY-MM-DD 포맷

endDatestring date required

검색할 근무 스케줄 종료일 / YYYY-MM-DD 포맷

Query parameters

employeeNumbersstring[] required

검색할 사원번호 목록

Response

Example response

{
  "userWorkSchedules": [
    {
      "employeeNumber": "A00010",
      "days": [
        {
          "date": "2025-12-09",
          "workBlocks": [
            {
              "formName": "근무",
              "blockFrom": "2025-12-09T10:00:00",
              "blockTo": "2025-12-09T12:30:00",
              "type": "WORK_CLOCK"
            },
            {
              "formName": "휴게",
              "blockFrom": "2025-12-09T12:30:00",
              "blockTo": "2025-12-09T14:00:00",
              "type": "WORK_CLOCK"
            },
            {
              "formName": "근무",
              "blockFrom": "2025-12-09T14:00:00",
              "type": "WORK_CLOCK"
            }
          ],
          "timeOffBlocks": [
            {
              "formName": "연차",
              "blockFrom": "2025-12-09T09:00:00",
              "blockTo": "2025-12-09T10:00:00",
              "usedMinutes": 60,
              "usedPaidMinutes": 30
            }
          ]
        }
      ]
    }
  ]
}