---
schema_version: "1"
id: 23b7adea0a6650f4a51c73b8d1c115b41eb4c1918c25a713af3e01b50622f3e2
title: Query Unified Record ID
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-query-guide/references/data-cloud-query-api-reference/universal-id-lookup/c360a-api-universal-id-lookup.md
canonical_url: https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-universal-id-lookup.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4f2522fa3071c59e81c5264ebea847ddc51993061496bcf512ded909c1079302
products:
  - Data 360 Query Guide
  - Data 360 Developer Documentation
---
# Query Unified Record ID

The Universal ID Lookup API provides a powerful way to retrieve all individual records associated with a unified record across different data sources. This API allows you to find all the individual IDs for a person across various systems, such as retail sales, loyalty programs, and mobile identity platforms.

## Key Features

- **Cross-System ID Lookup**: Retrieve all individual records linked to a unified record
- **Data Source Integration**: Query across different data sources using a single ID
- **Identity Resolution**: Link customer records from multiple systems
- **Unified Profile Access**: Access complete customer profiles across platforms

## Prerequisites

- Data Cloud licenses must be provisioned for your org
- Users must have appropriate roles and permissions assigned
- Authentication requires a valid access token
- External Client App must be properly configured

## API Limits

- Maximum of 50 fields can be retrieved per request
- Default return limit is 49,999 rows
- Only AND logical operator and equality comparator are supported
- No limit on the number of filters in a query
- Date/time fields must use the format: `YYYY-MM-DD HH:MM:SS`

## Available Endpoints

- [**GET /api/v1/universalIdLookup/{entity_name}/{DataSourceId**c}/{DataSourceObjectId**c}/{SourceRecordId\_\_c}**](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-universalidlookup-entity-name-datasourceid.md)

  Retrieve all individual records associated with a unified record across all data sources.

## Use Cases

1. **Customer Profile Consolidation**

   - Find all customer records across different systems
   - Link customer data from multiple sources
   - Create a unified view of customer information

2. **Data Integration**

   - Connect customer data from various platforms
   - Maintain consistent customer identification
   - Enable cross-system data analysis

3. **Identity Resolution**
   - Resolve customer identities across systems
   - Link anonymous and known customer profiles
   - Create a single source of truth for customer data

## Notes

- The API follows REST standards for consistency and ease of use
- All responses are in JSON format
- Error responses include detailed error messages
- The API supports both primary and secondary key lookups
- You must explicitly specify fields to retrieve more than 10 fields

## Additional Resources

- [User Roles and Permission Sets in Data 360](https://help.salesforce.com/s/articleView?id=data.c360_a_userpermissions.htm&type=5)
- [Set Up an External Client App](https://help.salesforce.com/s/articleView?id=xcloud.external_client_apps.htm&type=5)
- [Getting Started with Data Cloud API](https://developer.salesforce.com/docs/data/data-cloud-ref/guide/c360a-getting-started-with-cdp.html)
- [API Limits for Profile, Query, and Calculated Insights](https://help.salesforce.com/s/articleView?id=data.c360_a_limits_and_guidelines_cdp.htm&type=5)