GET/business-support/attendance/annual-leaves

사용자의 연차 정보 목록을 조회한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증를 참고한다.

Scope

businessSupport.attendance
businessSupport.attendance.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/business-support/attendance/annual-leaves

Query Parameters

ParameterTypeDescription
userId string 

사용자 ID

 
baseDate string 

연차 조회 기준 일 (required:false)


example : 2023-07-01 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

연차 정보 목록 결과

PropertyTypeDescription
annualLeaves array (AnnualLeave) 
 
responseMetaData object (responseMetaData) 

응답 메타데이터

 

AnnualLeave

PropertyTypeDescription
userId string 

사용자 아이디


format : int64 
userName string 

사용자 이름

 
startDate string 

연차 시작일

 
endDate string 

연차 종료일

 
occurredCount number 

발생 연차 수


format : double 
usedCount number 

사용 연차 수


format : double 
remainedCount number 

잔여 연차 수


format : double 
adjustmentCount number 

조정 연차 수


format : double 
lessThanOneYearCount number 

1년 미만 연차 수


format : double 
carriedForwardCount number 

이월 연차 수


format : double 

responseMetaData

PropertyTypeDescription
nextCursor string 

다음 목록 조회 시 사용하는 커서값

 

Response Example

Example 1

1{2  "annualLeaves": [3    {4      "userId": "userf7da-f82c-4284-13e7-030f3b4c756x",5      "userName": "김선영",6      "startDate": "2023-07-01",7      "endDate": "2024-06-30",8      "occurredCount": 15.5,9      "usedCount": 0,10      "remainedCount": 16,11      "adjustmentCount": 1,12      "lessThanOneYearCount": 0,13      "carriedForwardCount": 014    },15    {16      "userId": "userf7da-f82c-4284-13e7-030f3b4c756x",17      "userName": "홍길동",18      "startDate": "2024-01-01",19      "endDate": "2024-12-31",20      "occurredCount": 16,21      "usedCount": 5,22      "remainedCount": 14,23      "adjustmentCount": 2,24      "lessThanOneYearCount": 0,25      "carriedForwardCount": 126    }27  ],28  "responseMetaData": {29    "nextCursor": "string"30  }31}