v1

구성원 근무 스케줄 (user-work-schedules)

사번으로 기간별 구성원 근무 스케줄 조회 (Get user work schedules by period and employee numbers)

구성원들의 기간별 근무 스케줄을 최장 31일까지 조회합니다.

get/v2/users/work-schedules/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-09T09:00:00",
              "blockTo": "2025-12-09T12:30:00"
            },
            {
              "formName": "근무",
              "blockFrom": "2025-12-09T13:30:00",
              "blockTo": "2025-12-09T17:00:00"
            }
          ],
          "timeOffBlocks": [
            {
              "formName": "연차",
              "blockFrom": "2025-12-09T09:00:00",
              "blockTo": "2025-12-09T10:00:00",
              "usedMinutes": 60,
              "usedPaidMinutes": 30
            }
          ]
        }
      ]
    }
  ]
}