---
title: "서명자 입력란 조회"
method: GET
path: "/documents/{documentId}/participant-fields"
tags: ["USER API"]
---

# 서명자 입력란 조회

`GET /documents/{documentId}/participant-fields`

## Path parameters

- `documentId` string, required

## Response `200`

- GetParticipantFieldsResponseDto
  - `participantFields` ParticipantFieldResponseDto[], nullable, required — 참여자 입력값 리스트
    - `dataLabel` string, required — 데이터 라벨
    - `groupDataLabel` string, nullable, required — 그룹 데이터 라벨
    - `participantId` string, required — 참여자 ID
    - `type` 'CHECKBOX' | 'TEXT' | 'SIGNATURE' | 'DROPDOWN' | 'NAME' | 'COMPANY_NAME' | 'ADDRESS' | 'DATE' | 'SIGNING_DATE' | 'IMAGE', required — 입력항목
    - `value` union, required — 참여자의 입력값 * 날짜, 참여한 날짜라면 ISO Date string (UTC Timezone) * 날짜, 참여한 날짜는 계약서 PDF에는 KST로 입력됨 * 입력항목이 텍스트, 드롭다운, 이름, 회사명 string * 입력항목이 사인/도장 또는 체크박스라면 true, false * 입력항목이 주소라면 AddressInputValue * 입력항목이 이미지라면 ImageInfo
      - boolean
      - string
      - AddressInputValue
        - `address1` string, required — 기본 주소
        - `address2` string, required — 상세 주소
        - `city` string, required — 시군구
        - `province` string, required — 도시
        - `zip` string, required — 우편번호
        - `country` object, required — 나라 코드
      - ImageInfo
        - `downloadUrl` string, required — 이미지 다운로드 링크

---

[API](https://skmtc.net/modusign/apis/modusign-api.md) · [All operations](https://skmtc.net/modusign/apis/modusign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modusign/modusign-api/versions/5772e872cbf9/schema)