GET /api/v1/dataGraph/{dataGraphName}?lookupKeys=[]

Queries data from a specific data graph using lookup keys. This endpoint allows you to retrieve records based on primary keys or lookup keys from any participating data model object.

  • HTTP Method: GET
  • Availability: Data Cloud v1.0, Salesforce v51.0
  • format: REST
  • URI: /api/v1/dataGraph/{dataGraphName}?lookupKeys=[]
ParameterTypeDescription
dataGraphNamestringRequired. The unique identifier of the data graph. Example: UnifiedIndividual_DG
ParameterTypeDescription
lookupKeysstringRequired. The lookup key in the format [DMO__dlm.field__c=value]. Example: [UnifiedLinkssotIndividualIr1__dlm.SourceRecordId__c=10000001]

The response includes:

  • data: Array of objects containing the requested data
  • done: boolean indicating if all results have been returned

This example shows the data graph UnifiedIndividual_DG queried using the field SourceRecordIdc=10000001 on the related object UnifiedLinkssotIndividualIr1dlm. The request to query the data graph is made using these elements:

  • DMO: UnifiedLinkssotIndividualIr1
  • Primary Key name: SourceRecordId
  • Primary Key value: 10000001
  • Lookup keys must be in the format [DMO__dlm.field__c=value]
  • The response includes all related fields from connected entities
  • Multiple lookup keys can be specified for more precise queries
  • The API supports both exact and fuzzy matching for lookup values
  • Results are limited to 1000 records per request