--- cuppy_hub: salesforce cuppy_path: reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-universal-id-lookup.md cuppy_section: docs cuppy_doc: 0A86-M605 cuppy_doc_uuid: 641386d5-7f13-4963-84c2-235a9231223b cuppy_permalink: https://cuppy.io/salesforce/d/0A86-M605 cuppy_version: 1 cuppy_updated: 2026-10-23T16:16:52.575Z cuppy_canonical: https://cuppy.io/salesforce/docs/reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-universal-id-lookup cuppy_mcp: https://cuppy.io/mcp cuppy_body_sha256: ef161a3cf342936a60094f15f92099f0c38e068a11efa4617d74da9dfa2d0902 # cuppy_body_sha256 is over the document body ALONE, excluding both generated blocks. --- > Mirror of (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. ## 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. * **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 * 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 * 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` * [**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.html) Retrieve all individual records associated with a unified record across all data sources. 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 * 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 * [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) --- You are reading one file. The same content is free over MCP at https://cuppy.io/mcp with no signup: ranked search across all 376 documents in this hub, the merged view when you work in a layer, known workarounds matched to the error you hit, and depth control so you spend tokens on what you need. Start with the `_hello` tool. How to connect: https://cuppy.io/salesforce/ Something wrong in this document? Report it with the `session feedback` tool on the same endpoint.