---
title: "사번으로 구성원 가족정보 조회 (Get user family details)"
method: GET
path: "/v2/users/family-details"
tags: ["구성원 가족 (user-family)"]
---

# 사번으로 구성원 가족정보 조회 (Get user family details)

`GET /v2/users/family-details`

사원번호로 구성원들의 가족정보를 조회합니다

## Query parameters

- `employeeNumbers` string[], required

## Response `200`

OK

- UserFamilyResponse
  - `userFamilyDetails` UserFamily[], required
    - `employeeNumber` string, required — 구성원 사번
    - `userFamilyMembers` UserFamilyMember[], required — 구성원 가족정보
      - `ssn` string — 구성원 가족의 주민등록번호
      - `name` string, required — 구성원 가족의 이름
      - `phoneNumber` string — 구성원 가족의 전화번호
      - `relation` 'ZZ' | '02' | '03' | '04' | '05' | '06' | '08' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '43' | '44' | '45' | '46' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '59' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '69' | '70' | '71' | '72' | '73' | '74' | '75' | '76' | '77' | '78' | '79' | '80' | '81' | '82' | '83' | '84' | '85' | '86' | '87' | '88' | '89' | '90' | '91' | '92' | '93' | '94' | '95' | '96' | '97' | '98' | '99' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'A7' | 'A8' | 'A9' | 'B1' | 'B2' | 'B3' | 'B4' | 'B5', required — 구성원과의 관계 - 국민건강보험법 시행규칙 [별지 제1호서식] 참고

---

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