API

문서 목록 조회

작성일 2026.03.24 | 수정일 2026.03.25

GET/crm-core/v1/documents

Query

documentTypeId— 문서 유형 ID로 필터링

entityId— 개체 ID로 필터링

recordId— 레코드 ID로 필터링

linkedRecordId— 연결 레코드 ID로 필터링

templateId— 템플릿 ID로 필터링

status— 문서 상태로 필터링 (DRAFT, FINALIZED, ARCHIVED)

startKey— 페이지네이션 시작 키 (이전 응답의 nextKey 값)

limit— 조회 개수 제한 (1~100, 기본값: 20)

문서 목록을 조회합니다. 커서 기반 페이지네이션을 지원합니다. 목록 조회 시 content, htmlContent, dataSnapshot 필드는 제외됩니다.

chat

MEMBER 역할은 본인 소유 문서와 소유자 미지정 문서만 조회됩니다. OWNER 역할은 모든 문서를 조회할 수 있습니다.

Response

Name	Type	Required	Description
data	Array<Object>	*	문서 목록
documentId	string	*	문서 고유 ID
accountId	string	*	계정 고유 ID
documentTypeId	string		문서 유형 ID
entityId	string		개체 ID
recordId	string		레코드 ID
templateId	string		템플릿 ID
linkedRecordIds	Array<String>		연결 레코드 ID 목록
issueMethod	string	*	발행 방식
name	string	*	문서 이름
attachments	Array<Object>		첨부파일 목록
status	string	*	문서 상태
ownerId	string		문서 소유자 멤버 ID
issuedAt	date		발행 일시
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜
nextKey	string		다음 페이지 조회를 위한 키 (마지막 페이지인 경우 미반환)

Structure

Response Structure

{
  "data": [
    {
      "documentId": "DOC20260324090000ABCDEFGHIJKLMNO",
      "accountId": "24010100001234",
      "documentTypeId": "DTYPE20260324090000ABCDEFGHIJKLM",
      "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
      "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
      "templateId": "DTPL20260324090000ABCDEFGHIJKLM",
      "issueMethod": "샘플값",
      "name": "샘플",
      "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
      "status": "ACTIVE",
      "dateCreated": "2026-03-24T09:00:00.000Z",
      "dateUpdated": "2026-03-24T09:00:00.000Z"
    }
  ],
  "nextKey": "nextKeyToken123"
}