API

레코드 기준 관계 목록 조회

작성일 2026.04.23 | 수정일 2026.04.23

GET/crm-core/v1/relationships/record/{recordId}
지정한 레코드가 소스 또는 대상으로 포함된 모든 관계를 조회한다. 한 레코드의 전체 연결 그래프를 확인하는 용도. 최대 500건 반환. 권한 요구: MEMBER 이상.

Path Params

NameTypeRequiredDescription
recordIdstring레코드 ID (CRMRC1...)

Response

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

Structure

코드 예제

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

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

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

lightbulb

대상 레코드가 `sourceRecordId` 또는 `targetRecordId` 어디에 있든 모두 반환한다. 레코드의 입·출 방향을 구분하려면 각 관계의 `sourceRecordId`/`targetRecordId`가 조회 대상 레코드 ID와 일치하는지 확인할 것.

lightbulb

응답은 최대 500건으로 제한된다. 그 이상이 필요한 경우 `GET /relationships/list` 엔드포인트의 커서 페이지네이션을 사용할 것.