Get Relationship with Reltio Lightspeed
Learn about the Predicate Query API (Reltio Lightspeed) operation to retrieve data records.
- You have
READ
privileges forMDM.Data.Entities.Profile
and ROLE_API Access permissions. - Attributes / Relationships / Crosswalks are indexed in the tenant configuration.
Reltio Lightspeed (Predicate API) Context
This operation enables you to retrieve records by specifying attribute values, relationship uri or crosswalk details, directly querying indexed data while bypassing broader search methods for improved performance.
Request
- Headers
- Provides information about authentication access token in the format "Bearer <accessToken>". For more information, see Authentication API.
Authentication: Bearer <token>
Parameter | Type | Description |
---|---|---|
queryType | String | Specifies the type of query (along with the corresponding object):
|
attribute | Object | Specifies the attribute details for the query:
|
crosswalk | Object | Specifies the crosswalk details for the query:
|
uri | String | Contains the object uri, when querying by this parameter. |
metadataTypes | List | Specifies the metadata types to be queried (optional); if absent, all indexed types are required. |
Request body structure - Attribute
Request body structure - Crosswalk
Request body structure - URI
Response
The response is a list of relationships in Reltio standard JSON format.
Example
- Request example
POST https://na07-test.reltio.com/reltio/api/<tenantId>/relations/_predicateQuery - Request body example
- This example demonstrates how to request a record by specifying the IndividualHasAddress attribute and its value.
{ "queryType" : "attribute", "metadataTypes" : [ "configuration/relationTypes/IndividualHasAddress" ], "attribute" : { "name" : "UUID", "value" : "REL1" } } - Response example
[ { "uri": "relations/0HOsbqP", "type": "configuration/relationTypes/IndividualHasAddress", "createdBy": "user@company.com", "createdTime": 1731000130176, "updatedBy": "user@company.com", "updatedTime": 1740505697274, "startRefPinned": false, "startRefIgnored": false, "endRefPinned": false, "endRefIgnored": false, "attributes": { "UUID": [ { "type": "configuration/relationTypes/IndividualHasAddress/attributes/UUID", "ov": true, "value": "REL1", "uri": "relations/0HOsbqP/attributes/UUID/rUOoYBQ" } ] }, "analyticsAttributes": {}, "crosswalks": [ { "uri": "relations/0HOsbqP/crosswalks/Fen6G0L", "type": "configuration/sources/PP", "value": "8474ae08-0eeb-4d15-baaa-98c555e1c9cb", "reltioLoadDate": "2025-02-25T17:48:17.274Z", "createDate": "2024-11-07T17:22:10.176Z", "updateDate": "2024-11-07T17:22:10.176Z", "attributes": [ "relations/0HOsbqP/attributes/UUID/rUOoYBQ" ], "singleAttributeUpdateDates": {} } ], "startObject": { "type": "configuration/entityTypes/Individual", "objectURI": "entities/0WCNzSn", "label": "Emma Thompson", "directionalLabel": "has an address at", "crosswalks": [ { "uri": "entities/0WCNzSn/crosswalks/Fen6KGb", "type": "configuration/sources/PP", "value": "1101", "reltioLoadDate": "2024-11-07T17:22:10.176Z", "createDate": "2024-11-07T17:22:10.176Z", "updateDate": "2024-11-07T17:22:10.176Z", "attributes": [ "entities/0WCNzSn/attributes/Full_Name/Fen5huH", "entities/0WCNzSn/attributes/UUID/Fen5Maz", "entities/0WCNzSn/attributes/SourceIdentifiers/Fen5QrF/Customer_ID/Fen5ZNl", "entities/0WCNzSn/attributes/SourceIdentifiers/Fen5QrF", "entities/0WCNzSn/attributes/SourceIdentifiers/Fen5QrF/Source_System/Fen5V7V", "entities/0WCNzSn/attributes/Phone/Fen5mAX", "entities/0WCNzSn/attributes/Phone/Fen5mAX/Phone_Number/Fen5qQn", "entities/0WCNzSn/attributes/Name_Prefix/Fen5de1" ], "singleAttributeUpdateDates": {} } ] }, "endObject": { "type": "configuration/entityTypes/Location", "objectURI": "entities/0WCO3j3", "label": "", "directionalLabel": "is an address for", "crosswalks": [ { "uri": "entities/0WCO3j3/crosswalks/Fen6Bk5", "type": "configuration/sources/PP", "value": "4fdf8571cc6feb6c57dee458961c7315", "reltioLoadDate": "2024-11-07T17:22:10.176Z", "createDate": "2024-11-07T17:22:10.176Z", "updateDate": "2024-11-07T17:22:10.176Z", "attributes": [], "singleAttributeUpdateDates": {} } ] } } ]