GET /api/v1/universalIdLookup/{entityName}/{DataSourceIdc}/{DataSourceObjectIdc}/{SourceRecordId__c}

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}
ParameterTypeDescription
entityNamestringRequired. The name of the bridge table entity.
DataSourceId__cstringRequired. The data source ID.
DataSourceObjectId__cstringRequired. The data source object ID.
SourceRecordId__cstringRequired. 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 ID
    • UnifiedRecordId__c: The unified record ID
    • ssot__DataSourceObjectId__c: The data source object ID
    • ssot__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