API

관계 유형별 관계 목록 조회

작성일 2026.04.23 | 수정일 2026.04.23

GET/crm-core/v1/relationships/type/{relationshipTypeId}
특정 관계 유형으로 생성된 모든 관계 인스턴스를 조회한다. 권한 요구: MEMBER 이상. 최대 500건 반환.

Path Params

NameTypeRequiredDescription
relationshipTypeIdstring관계 유형 ID (CRMRT1...)

Response

NameTypeRequiredDescription
[]Array관계 배열 (최상위)
[].relationshipIdstring관계 ID
[].sourceEntityIdstring소스 개체 ID
[].sourceRecordIdstring소스 레코드 ID
[].targetEntityIdstring대상 개체 ID
[].targetRecordIdstring대상 레코드 ID
[].relationshipTypeIdstring관계 유형 ID
[].metadataObject관계 메타데이터
[].dateCreateddate생성 시각
[].dateUpdateddate마지막 수정 시각

Structure

코드 예제

const typeId = 'CRMRT1260423091530123RTP11122233';
const response = await fetch(https://api.solapi.com/crm-core/v1/relationships/type/${typeId}, {
  headers: { 'Authorization': 'Bearer ' + TOKEN }
});
const data = await response.json();
import requests

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

curl 'https://api.solapi.com/crm-core/v1/relationships/type/CRMRT1260423091530123RTP11122233' \
  -H 'Authorization: Bearer YOUR_TOKEN'

lightbulb

응답은 최대 500건으로 제한된다. 대용량 조회나 페이지네이션이 필요하면 `GET /relationships/list?relationshipTypeId=...`를 사용할 것.