API

레코드 조회

작성일 2026.03.24 | 수정일 2026.04.14

GET/crm-core/v1/records/:recordId
:recordId — 레코드 고유 아이디

특정 레코드의 상세 정보를 조회합니다. 속성 값은 EAV(Entity-Attribute-Value) 패턴으로 저장된 데이터가 병합되어 반환됩니다.

Response| Name | Type | Required | Description |
| ------ | ------ | ------ | ------ | | recordId | string | | 레코드 고유 아이디 | | accountId | string | | 계정 고유 아이디 | | entityId | string | | 개체 ID | | name | string | | 레코드 이름 | | data | Object | | 레코드 데이터 (속성 ID를 키로, 속성 값을 값으로 하는 객체) | | tags | Array\ | | 태그 목록 | | ownerId | string | | 소유자 멤버 ID | | profileImage | Object | | 프로필 이미지 | | profileImage.fileId | string | | 파일 고유 아이디 | | profileImage.url | string | | 이미지 URL (서명된 URL) | | profileImage.thumbnailUrl | string | | 썸네일 URL (서명된 URL) | | profileImage.fileName | string | | 파일 이름 | | profileImage.fileSize | number | | 파일 크기 (바이트) | | profileImage.mimeType | string | | MIME 타입 | | images | Array\ | | 이미지 목록 | | images[].fileId | string | | 파일 고유 아이디 | | images[].url | string | | 이미지 URL (서명된 URL) | | images[].thumbnailUrl | string | | 썸네일 URL (서명된 URL) | | images[].fileName | string | | 파일 이름 | | images[].order | number | | 이미지 순서 | | attachments | Array\ | | 첨부파일 목록 | | attachments[].fileId | string | | 파일 고유 아이디 | | attachments[].url | string | | 파일 URL (서명된 URL) | | attachments[].fileName | string | | 파일 이름 | | attachments[].fileSize | number | | 파일 크기 (바이트) | | attachments[].mimeType | string | | MIME 타입 | | attachments[].title | string | | 첨부파일 제목 | | attachments[].description | string | | 첨부파일 설명 | | isDeleted | boolean | | 삭제 여부 | | createdBy | string | | 최초 생성자 멤버 ID | | updatedBy | string | | 최근 수정자 멤버 ID | | dateCreated | date | | 최초 생성 날짜 | | dateUpdated | date | | 최근 수정 날짜 |## Structure ``

json Response Structure
{
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "accountId": "24010100001234",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "name": "샘플",
  "data": {
    "propertyId1": "value1",
    "propertyId2": "value2"
  },
  "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"
  },
  "images": [
    {
      "fileId": "FILE20260324090000ABCDEFGHIJKLMN",
      "url": "https://storage.solapi.com/files/image.jpg",
      "thumbnailUrl": "https://storage.solapi.com/files/image-thumb.jpg",
      "fileName": "image.jpg",
      "order": 1
    }
  ],
  "attachments": [
    {
      "fileId": "FILE20260324090000ABCDEFGHIJKLMN",
      "url": "https://storage.solapi.com/files/document.pdf",
      "fileName": "document.pdf",
      "fileSize": 204800,
      "mimeType": "application/pdf",
      "title": "계약서",
      "description": "2026년 계약서"
    }
  ],
  "isDeleted": false,
  "createdBy": "MEM20260324090000ABCDEFGHIJKLMNO",
  "updatedBy": "MEM20260324090000ABCDEFGHIJKLMNO",
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}