Retrieve Individual Records by Unified ID
Retrieves all individual records associated with a unified record across different data sources. This endpoint allows you to find all individual IDs for a person across various systems, such as retail sales, loyalty programs, and mobile identity platforms.
- HTTP Method: GET
- Availability: Data Cloud v1.0, Salesforce API version 54.0 and later
- Format: REST
- URI:
/api/v1/universalIdLookup/{entityName}/{DataSourceId__c}/{DataSourceObjectId__c}/{SourceRecordId__c}
| Parameter | Type | Description |
|---|---|---|
| entityName | string | Required. The name of the bridge table entity. |
| DataSourceId__c | string | Required. The data source ID. |
| DataSourceObjectId__c | string | Required. The data source object ID. |
| SourceRecordId__c | string | Required. The primary key of the data source record. |
SourceRecordId__c maps to Individual ID of Individual data model object. For more information, see Individual DMO.
The response includes:
data: Array of record objects containing the requested data- Each record contains:
SourceRecordId__c: The source record IDUnifiedRecordId__c: The unified record IDssot__DataSourceObjectId__c: The data source object IDssot__DataSourceId__c: The data source ID
- The API follows REST standards for consistency
- All responses are in JSON format
- Error responses include detailed error messages
- The API supports both primary and secondary key searches
- You must explicitly specify fields to retrieve more than 10 fields