API

속성 목록 조회

작성일 2026.03.24 | 수정일 2026.04.14

GET/crm-core/v1/properties

속성 목록을 조회합니다. 최대 500개까지 조회됩니다.

Query

NameTypeRequiredDescription
entityIdstring개체 ID로 필터링
keywordstring속성 이름으로 검색

Response| Name | Type | Required | Description |


| ------ | ------ | ------ | ------ |
| propertyId | string | | 속성 고유 ID |
| accountId | string | | 계정 고유 ID |
| entityId | string | | 개체 ID |
| name | string | | 속성 이름 |
| description | string | | 속성 설명 |
| fieldType | string | | 속성 유형 |
| propertyGroupId | string | | 속성 그룹 ID |
| key | string | | 속성 키 (null 가능) |
| isMasked | boolean | | 마스킹 처리 여부 |
| options | Array\ | | 선택지 목록 |
| options[].label | string | | 선택지 라벨 |
| options[].value | string | | 선택지 값 |
| options[].priority | number | | 정렬 순서 |
| createdBy | string | | 생성한 멤버 ID |
| updatedBy | string | | 최근 수정한 멤버 ID |
| dateCreated | date | | 최초 생성 날짜 |
| dateUpdated | date | | 최근 수정 날짜 |

Structure


``json Response Structure
[
{
"propertyId": "PROP20260324090000ABCDEFGHIJKLM",
"accountId": "24010100001234",
"entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
"name": "샘플",
"description": "설명 텍스트",
"fieldType": "TEXT",
"propertyGroupId": "ID_SAMPLE_12345",
"key": "sample_key",
"isMasked": false,
"options": [],
"createdBy": "MEM20260101000000ABCDEFGHIJKLMNO",
"updatedBy": "MEM20260101000000ABCDEFGHIJKLMNO",
"dateCreated": "2026-03-24T09:00:00.000Z",
"dateUpdated": "2026-03-24T09:00:00.000Z"
}
]
``