Data Cloud Reference Guide
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Retrieve Metadata
GET /api/v1/dataGraph/metadata
GET /api/v1/dataGraph/metadata?entityName={dataGraphName}
GET /api/v1/dataGraph/{dataGraphName}/{dataGraphRecordId}
GET /api/v1/dataGraph/{dataGraphName}?lookupKeys=[]
Query Services Status Codes
CDP Python Connector
API Limits for Profile, Query, and Calculated Insights
Query Data Graph Data
To query
metadata
and data from data graphs, use the Data Graphs
APIs.
- Your orgs must be provisioned with Data Cloud licenses.
- To have full access to objects in Data Cloud, users must be assigned to appropriate roles. See User Roles and Permission Sets in Data Cloud.
- To authenticate, you must acquire and exchange an access token. For details, seeGetting Started.
Important
In example URLs, TSE refers to a tenant-specific endpoint, a unique, system-generated endpoint to each of your orgs.
Tip
-
GET /api/v1/dataGraph/metadata
Request a list of all data graphs and their primary data model object, related objects, and fields. -
GET /api/v1/dataGraph/metadata?entityName={dataGraphName}
Request the metadata for a single data graph object. Returned data includes the object's primary data model object, related objects, and fields. -
GET /api/v1/dataGraph/{dataGraphName}/{dataGraphRecordId}
Request data from a specified data graph. -
GET /api/v1/dataGraph/{dataGraphName}?lookupKeys=[]
Use secondary lookup keys to request data from a data graph.