---
title: "문서 이력 조회"
method: GET
path: "/documents/{documentId}/histories"
tags: ["USER API"]
---

# 문서 이력 조회

`GET /documents/{documentId}/histories`

## Path parameters

- `documentId` string, required

## Response `200`

- GetAllDocumentHistoriesResponseDto
  - `histories` HistoryDto[], required — 문서 이력
    - `message` string, required — 이력을 문장으로 요약한 메세지
    - `timestamp` string, date-time, required — 이력이 발생한 시간
    - `action` 'START_SIGNING_REQUEST' | 'SIGNING_REQUEST' | 'SIGNING_REQUEST_TO_HOST' | 'FIRST_READING_DOCUMENT_IN_SIGNING_TURN' | 'READING_DOCUMENT_IN_SIGNING_TURN' | 'VERIFICATION_FAILURE' | 'VERIFICATION_EXCEEDED' | 'VERIFICATION_COMPLETED' | 'SIGNING_COMPLETED' | 'SIGNING_COMPLETED_ALL' | 'REJECT_SIGNING' | 'CANCEL_SIGNING' | 'CANCEL_SIGNING_REQUEST' | 'REMIND_SIGNING' | 'CHANGE_SIGNING_EXPIRY_DATE' | 'CORRECT_SIGNING' | 'START_SESSION' | 'START_VIEW_ONLY_REQUEST' | 'VIEW_ONLY_REQUEST' | 'VIEW_ONLY_COMPLETED' | 'VIEW_ONLY_COMPLETED_ALL' | 'CANCEL_VIEW_ONLY_REQUEST' | 'FIRST_READING_VIEW_ONLY_IN_OWN_TURN' | 'READING_VIEW_ONLY_IN_OWN_TURN' | 'REMIND_VIEW_ONLY' | 'CHANGE_VIEWING_EXPIRY_DATE' | 'BULK_SIGNING_COMPLETED' | 'MODIFICATION_STARTED' | 'MODIFICATION_COMPLETED' | 'MODIFICATION_CANCELED' | 'SIGNER_INFO_CHANGED' | 'SIGNER_ADDED' | 'SIGNER_REMOVED' | 'SIGNERS_CHANGED' | 'DOCUMENT_SETTINGS_CHANGED' | 'SIGNER_ATTACHMENT_CHANGED' | 'SIGNER_ORDER_CHANGED' | 'FIELD_MODIFIED' | 'REQUESTER_FIELD_MODIFIED' | 'FIELD_GROUP_CHANGED' | 'TITLE_CHANGED' | 'ATTACHMENT_CHANGED' | 'VERIFICATION_CHANGED' | 'DOCUMENT_FILE_CHANGED' | 'CARBON_COPY_CHANGED' | 'PDF_PASSWORD_CHANGED' | 'SIGNING_PERIOD_CHANGED' | 'CHANGE_PARTICIPANT_DELEGATION_PERIOD' | 'INTERRUPT_PARTICIPANT_DELEGATION', required — 이력의 액션: * `START_SIGNING_REQUEST` - 서명 요청 시작 * `SIGNING_REQUEST` - 서명 요청 됨 * `FIRST_READING_DOCUMENT_IN_SIGNING_TURN` - 서명 차례에 첫 문서 조회 * `READING_DOCUMENT_IN_SIGNING_TURN` - 서명 차례에 문서 조회 * `VERIFICATION_FAILURE` - 추가 인증 실패 * `VERIFICATION_EXCEEDED` - 추가 인증 5회 실패 * `VERIFICATION_COMPLETED` - 인증 성공 * `SIGNING_COMPLETED` - 서명 입력 * `SIGNING_COMPLETED_ALL` - 모든 서명 입력 완료 * `REJECT_SIGNING` - 서명 거절 * `CANCEL_SIGNING` - 서명 취소 * `CANCEL_SIGNING_REQUEST` - 서명 요청 취소 * `REMIND_SIGNING` - 서명 알림 재전송 * `CHANGE_SIGNING_EXPIRY_DATE` - 서명 유효 기간 수정 * `CORRECT_SIGNING` - 서명 수정 * `SIGNING_REQUEST_TO_HOST` - 호스트에게 서명 요청 * `START_SESSION` - 대면 서명 세션 시작 * `START_VIEW_ONLY_REQUEST` - 열람 요청 시작 * `VIEW_ONLY_REQUEST` - 열람 요청 * `VIEW_ONLY_COMPLETED` - 열람 완료 * `VIEW_ONLY_COMPLETED_ALL` - 모든 열람 완료 * `CANCEL_VIEW_ONLY_REQUEST` - 열람 요청 취소 * `FIRST_READING_VIEW_ONLY_IN_OWN_TURN` - 열람 요청자가 문서 처음 열람 * `READING_VIEW_ONLY_IN_OWN_TURN` - 열람 요청자가 문서 열람 * `REMIND_VIEW_ONLY` - 열람 재요청 * `CHANGE_VIEWING_EXPIRY_DATE` - 열람 만료일 변경 * `MODIFICATION_STARTED` - 수정 시작 * `MODIFICATION_COMPLETED` - 수정 완료 * `MODIFICATION_CANCELED` - 수정 되돌리기 * `SIGNER_INFO_CHANGED` - 서명자 정보 변경 * `SIGNER_ADDED` - 서명자 추가 * `SIGNER_REMOVED` - 서명자 삭제 * `SIGNERS_CHANGED` - 서명자 변경 (통합) * `DOCUMENT_SETTINGS_CHANGED` - 문서 설정 변경 (통합) * `SIGNER_ATTACHMENT_CHANGED` - 서명자 첨부 변경 * `SIGNER_ORDER_CHANGED` - 서명 순서 변경 * `FIELD_MODIFIED` - 입력란 변경 * `REQUESTER_FIELD_MODIFIED` - 요청자 편집 필드 변경 * `FIELD_GROUP_CHANGED` - 필드 그룹 변경 * `TITLE_CHANGED` - 제목 변경 * `ATTACHMENT_CHANGED` - 첨부 변경 * `VERIFICATION_CHANGED` - 인증수단 변경 * `DOCUMENT_FILE_CHANGED` - 원본 파일 변경 * `CARBON_COPY_CHANGED` - 참조인 변경 * `PDF_PASSWORD_CHANGED` - PDF 비밀번호 변경 * `SIGNING_PERIOD_CHANGED` - 서명 기한 변경 * `CHANGE_PARTICIPANT_DELEGATION_PERIOD` - 참여자 대리 기간 변경 * `INTERRUPT_PARTICIPANT_DELEGATION` - 참여자 대리 중단
    - `generator` Generator, required
      - `type` 'SYSTEM' | 'PARTICIPANT' | 'REQUESTER' | 'ADMIN', nullable, required — 발생자의 종류 * `REQUESTER` - 요청자 * `ADMIN` - 관리자 * `PARTICIPANT` - 참여자 * `SYSTEM` - 시스템
      - `name` string, nullable, required — 발생자의 이름
      - `contact` string, nullable, required — 발생자의 연락처 (이메일 또는 전화번호)
      - `environment` Environment, required
        - `userIp` string, nullable, required — 발생자의 IP 주소
        - `userAgent` string, required — 발생자 브라우저의 user-agent
    - `target` Target, required
      - `type` 'PARTICIPANT', required — 이력의 대상자 종류
      - `name` string, required — 대상자의 이름
      - `contact` string, required — 대상자의 연락처 (이메일 또는 전화번호)
    - `details` Detail, required
      - `authType` 'PASSWORD' | 'MOBILE' | 'D_CERT', required — 인증 수단 (action이 `VERIFICATION_FAILURE`, `VERIFICATION_EXCEEDED`, `VERIFICATION_COMPLETED` 일 때)
      - `failureCount` number, nullable, required — 누적 실패한 횟수 (action이 `VERIFICATION_FAILURE` 일 때)

---

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