v1

구성원 마스터 (user-masters)

사번으로 구성원 마스터 목록 조회 (Get user masters by employee numbers)

사원번호로 구성원들의 정보를 조회합니다. 인사발령 기록의 경우 현재 정보를 조회하므로 입사예정자, 퇴사자의 경우 비어있을 수 있습니다. /users/departments를 활용하여 입사예정일, 퇴사일의 조직, 직책을 조회할 수 있습니다.

get/v2/user-masters

Query parameters

employeeNumbersstring[] required

검색할 사원번호 목록

Response

Example response

{
  "users": [
    {
      "employeeNumber": "A00010",
      "name": "홍길동",
      "nameInOffice": "John Doe",
      "englishName": {
        "firstName": "gildong",
        "lastName": "hong"
      },
      "email": "gildong.hong@flex.team",
      "phoneNumber": "01012345678",
      "phoneNumbers": [
        {
          "type": "PERSONAL",
          "value": "+821012345678"
        }
      ],
      "gender": "남/여",
      "companyGroupJoinDate": "2021-01-01",
      "companyJoinDate": "2022-01-01",
      "companyLeaveDate": "2022-12-31",
      "flexUsageEndDate": "2022-12-31",
      "primaryDepartment": {
        "departmentCode": "10000",
        "parentDepartmentCode": "1000",
        "name": "인사팀",
        "sortOrder": "1001, 1002,..",
        "visible": true,
        "beginDate": "2022-01-01",
        "endDate": "9999-12-31"
      }
    }
  ]
}