Get Relationship with Reltio Lightspeed

Learn about the Predicate Query API (Reltio Lightspeed) operation to retrieve data records.

Note: Reltio Lightspeed is only available on Amazon Web Services (AWS) and Google Cloud Platform (GCP).

Important: Before you begin, ensure:

You have READ privileges for MDM.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

POST /api/{tenant}/relations/_predicateQuery

Headers: Provides information about authentication access token in the format "Bearer <accessToken>". For more information, see Authentication API.Authentication: Bearer <token>

Table 1. Body parameters
Parameter	Type	Description
queryType	String	Specifies the type of query (along with the corresponding object): attribute crosswalk uri
attribute	Object	Specifies the attribute details for the query: name - the attribute name to query by; for subnested attributes, use <nestedName>.<subNestedName> value - the attribute value to query by
crosswalk	Object	Specifies the crosswalk details for the query: type - the crosswalk type value - the crosswalk value sourceTable - the source table associated with the crosswalk
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

{
  "queryType": "attribute",
  "attribute": {
    "name": "string",
    "value": {}
  },
  "metadataTypes": [
    "string"
  ]
}

Request body structure - Crosswalk

{
  "queryType": "crosswalk",
  "crosswalk": {
    "type": "string",
    "value": "string",
    "sourceTable": "string"
  },
  "metadataTypes": [
    "string"
  ]
}

Request body structure - URI

{
  "queryType": "uri",
  "uri": "string",
  "metadataTypes": [
    "string"
  ]

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": {} } ] } } ]

You've found your way to a temporary environment. Content is not complete or final. Looking for Reltio documentation? Go to docs.reltio.com.

Unify and manage your data