---
title: "사번으로 구성원 마스터 목록 조회 (Get user masters by employee numbers)"
method: GET
path: "/v2/user-masters"
tags: ["구성원 마스터 (user-masters)"]
---

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

`GET /v2/user-masters`

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

## Query parameters

- `employeeNumbers` string[], required

## Response `200`

OK

- UserMastersResponse
  - `users` UserMasterDto[], required — 검색된 구성원 목록
    - `employeeNumber` string, required — 구성원의 사원번호
    - `name` string, required — 구성원의 이름
    - `nameInOffice` string, nullable — 구성원의 회사 내 이름
    - `englishName` UserNameDto, nullable — 구성원의 영문이름
      - `firstName` string, required — first name(이름)
      - `lastName` string, required — last name(성)
    - `email` string, required — 구성원의 이메일 주소
    - `phoneNumber` string, nullable — 구성원의 전화번호
    - `phoneNumbers` PhoneNumber[], nullable, required — 구성원의 전화번호 목록
      - `type` 'PERSONAL', required — 전화번호 타입
      - `value` string, nullable — 전화번호 - 국제 전화번호 표준(E.164)포맷에 맞지 않는 경우 null이 반환될 수 있습니다.
    - `ssn` string, nullable — 구성원의 주민등록번호
    - `birthday` string, date, nullable — 구성원의 생일
    - `gender` 'MALE' | 'FEMALE', nullable — 구성원의 성별
    - `profileImageUrl` string, nullable — 구성원의 프로필 이미지 주소
    - `companyGroupJoinDate` string, date, nullable — 구성원의 그룹입사일
    - `companyJoinDate` string, date, nullable — 구성원의 입사일
    - `companyLeaveDate` string, date, nullable — 구성원의 퇴사일
    - `flexUsageEndDate` string, date, nullable — 구성원의 flex 사용 종료일
    - `employmentContract` 'UNKNOWN' | 'REGULAR' | 'CONTRACT' | 'DISPATCH' | 'DAILY_WORK' | 'FREELANCER' | 'ASSOCIATE' | 'REGISTERED_EXECUTIVE' | 'NON_REGISTERED_EXECUTIVE', nullable — 구성원의 근로 계약 유형
    - `homeAddress` UserAddressDto, nullable — 구성원의 집 주소
      - `address` string, required — address(주소)
      - `addressDetail` string, required — detail address(상세주소)
      - `addressCountry` string, required — country(국가)
      - `addressState` string, required — state(도)
      - `addressCity` string, required — city(시)
      - `address1` string, required
      - `address2` string, required
      - `address3` string, required
      - `addressZipCode` string, required — zipcode(우편번호)
    - `primaryDepartment` DepartmentDto, nullable — 구성원의 주 소속조직
      - `departmentCode` string, required — 조직코드
      - `parentDepartmentCode` string, nullable — 상위 조직코드
      - `name` string, required — 조직 이름
      - `displayOrder` integer, required — 같은 상위 조직을 갖는 조직 간 정렬 순서
      - `sortOrder` string, nullable — 전체 조직 정렬 순서, flex와 별도의 정렬을 설정하고 싶을 경우에만 사용. 기본 미제공
      - `visible` boolean, required — 조직의 표시 여부
      - `beginDate` string, date, nullable — 조직의 생성일
      - `endDate` string, date, nullable — 조직의 폐쇄일
    - `primaryJobRole` JobRoleCodeDto, nullable — 구성원의 주 직무
      - `jobRoleCode` string, required — 직무
    - `primaryJobRank` JobRankCodeDto, nullable — 구성원의 주 직위
      - `jobRankCode` string, required — 직위
    - `primaryJobTitle` JobTitleCodeDto, nullable — 구성원의 주 직책
      - `jobTitleCode` string, required — 직책
    - `primaryJobLevel` JobLevelCodeDto, nullable — 구성원의 주 직급
      - `jobLevelCode` string, required — 직급
    - `primaryJobGroup` JobGroupCodeDto, nullable — 구성원의 주 직군
      - `jobGroupCode` string, required — 직군
    - `customProperties` UserCustomPropertyDto[], required — 사용자정의 구성원 정보
      - `key` string, required — 커스텀 프로퍼티 키
      - `value` string, required — 커스텀 프로퍼티 값

---

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