Mirror of <https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-universalidlookup-entity-name-datasourceid.html> (Salesforce, Data 360 Query Guide), read 2026-10-23. Salesforce's own page is the authority; this copy exists because that site refuses non-browser readers.

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 360 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 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