API

레코드 목록 조회

작성일 2026.03.24 | 수정일 2026.04.14

GET/crm-core/v1/records
?entityId=개체 ID로 필터링
?keyword=레코드 이름으로 검색
?filters=속성 필터 (JSON 문자열). 지원하는 연산자: contains, eq, in, dateRange, numberRange, number
?segmentId=세그먼트 ID로 필터링 (최대 50자)
?recordIds=콤마로 구분된 레코드 ID 목록으로 필터링
?startKey=페이지네이션 시작 키 (이전 응답의 nextKey 값)
?limit=조회 개수 제한 (1~500, 기본값: 20)
?sortField=정렬 기준 필드 (name, dateCreated, dateUpdated, recordId 또는 속성 ID)
?sortDirection=정렬 방향 (asc 또는 desc)

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

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

Response| Name | Type | Required | Description |

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

json Response Structure
{
  "data": [
    {
      "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
      "accountId": "24010100001234",
      "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
      "name": "샘플",
      "data": {
        "key": "value"
      },
      "tags": ["샘플값"],
      "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
      "profileImage": {
        "fileId": "FILE20260324090000ABCDEFGHIJKLMN",
        "url": "https://storage.solapi.com/files/sample.jpg",
        "thumbnailUrl": "https://storage.solapi.com/files/sample-thumb.jpg",
        "fileName": "photo.jpg",
        "fileSize": 102400,
        "mimeType": "image/jpeg"
      },
      "dateCreated": "2026-03-24T09:00:00.000Z",
      "dateUpdated": "2026-03-24T09:00:00.000Z"
    }
  ],
  "nextKey": "nextKeyToken123"
}