API

관계 유형 목록 조회

작성일 2026.04.23 | 수정일 2026.04.23

GET/crm-core/v1/relationships/types
계정에 정의된 관계 유형 목록을 조회한다. 개체 ID를 지정하면 해당 개체가 소스 또는 대상으로 포함된 관계 유형만 반환한다. 최대 200건. 권한 요구: MEMBER 이상.

Query Params

NameTypeRequiredDescription
entityIdstring개체 ID로 필터링 (소스 또는 대상 어느 쪽이든 일치)

Response

NameTypeRequiredDescription
[]Array관계 유형 배열 (최상위)
[].relationshipTypeIdstring관계 유형 ID
[].namestring관계 유형 이름
[].descriptionstring설명
[].sourceEntityIdstring소스 개체 ID
[].targetEntityIdstring대상 개체 ID
[].sourceLabelstring소스 방향 레이블
[].targetLabelstring대상 방향 레이블
[].dateCreateddate생성 시각
[].dateUpdateddate*마지막 수정 시각

Structure

코드 예제

const params = new URLSearchParams({ entityId: 'CRMET1260423081530123XYZ11122233' });
const response = await fetch(https://api.solapi.com/crm-core/v1/relationships/types?${params}, {
  headers: { 'Authorization': 'Bearer ' + TOKEN }
});
const data = await response.json();
import requests

response = requests.get(
'https://api.solapi.com/crm-core/v1/relationships/types',
headers={'Authorization': f'Bearer {TOKEN}'},
params={'entityId': 'CRMET1260423081530123XYZ11122233'}
)
data = response.json()

curl -G 'https://api.solapi.com/crm-core/v1/relationships/types' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data-urlencode 'entityId=CRMET1260423081530123XYZ11122233'

lightbulb

`entityId`를 비워 두면 계정 내 모든 관계 유형이 반환된다. 최대 200건까지만 반환되므로 대량 관리가 필요한 경우 프론트엔드에서 이름 기반 검색을 함께 제공하는 것을 권장한다.