API

레코드 목록 조회

작성일 2026.03.24 | 수정일 2026.03.25

GET/crm-core/v1/records

Query

entityId— 개체 ID로 필터링

keyword— 레코드 이름으로 검색

filters— 속성 필터 (JSON 문자열) 지원하는 연산자: `contains`, `eq`, `in`, `dateRange`, `numberRange`, `number`

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

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

sortField— 정렬 기준 필드 (name, dateCreated, dateUpdated, recordId 또는 속성 ID)

sortDirection— 정렬 방향 (asc 또는 desc)

레코드 목록을 조회합니다. 커서 기반 페이지네이션을 지원합니다.

chat

정렬 기준으로 사용할 수 있는 기본 필드: name, dateCreated, dateUpdated, recordId. 속성 ID를 직접 지정하여 속성 값 기준 정렬도 가능합니다.

Response

Name	Type	Required	Description
data	Array<Object>	*	레코드 목록
recordId	string	*	레코드 고유 ID
accountId	string	*	계정 고유 ID
entityId	string	*	개체 ID
name	string	*	레코드 이름
data	Object		레코드 데이터 (속성 값)
tags	Array<String>		태그 목록
links	Object		연결 목록
ownerId	string		소유자 멤버 ID
profileImage	Object		프로필 이미지
fileId	string	*	파일 고유 ID
url	string	*	이미지 URL (서명된 URL)
thumbnailUrl	string		썸네일 URL (서명된 URL)
fileName	string	*	파일 이름
fileSize	number	*	파일 크기 (바이트)
mimeType	string	*	MIME 타입
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜
nextKey	string		다음 페이지 조회를 위한 키 (마지막 페이지인 경우 미반환)

Structure

Response Structure

{
  "data": [
    {
      "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
      "accountId": "24010100001234",
      "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
      "name": "샘플",
      "data": {
        "key": "value"
      },
      "tags": [
        "샘플값"
      ],
      "links": {
        "key": "value"
      },
      "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
      "profileImage": {
        "fileId": "FILE20260324090000ABCDEFGHIJKLMN",
        "url": "https://storage.solapi.com/files/sample.pdf",
        "thumbnailUrl": "샘플값"
      },
      "dateCreated": "2026-03-24T09:00:00.000Z",
      "dateUpdated": "2026-03-24T09:00:00.000Z"
    }
  ],
  "nextKey": "nextKeyToken123"
}