Retrieve matched assets - Precisely Data Integrity Suite

Data Integrity Suite APIs
Product
Data_Integrity
Spatial_Analytics
Data_Enrichment
geo_addressing_1
Services
Spatial Analytics
Data Enrichment
Geo Addressing
ft:title
Data Integrity Suite APIs
ft:locale
en-US
PublicationType
pt_developer
copyrightfirst
2023
copyrightlast
2026

Returns a list of matched assets.

HTTP

GET https://hostname/v2/catalog/lineage/{assetId}/asset-matches

Request

Path parameters

Key Required Type Value Description
assetId Yes string objectId

Specifies object ID for asset to retrieve tracing by upstream lineage relations.

Query parameters

Key Required Type Value Description
filter No string field:operator(value):index

Filter the results by specifying one or more filters.

Filter operators:

  • eq Equal to
  • ne Not equal to
  • lt Less than
  • le Less than or equal to
  • gt Greater than
  • ge Greater than or equal to
  • in In a list of comma separated values
  • ni Not in a list of comma separated values
  • ct Contains a value
  • sw Starts with a value
  • ew Ends with a value
  • ex Exists (only accepts Boolean (true or false) values)

By default, multiple filter expressions are combined in an AND expression. Filter expressions can be grouped by appending the optional group index (:0, :1,…,, :n ) to each filter expression. Filters in the same group are combined using AND while different groups are combined using OR.

For example, these filter expressions are in two different groups (0 and 1), so the combined expressions return results where name is either Bob or Alice.

filter=name:eq(Bob):0&filter=name:eq(Alice):1

Filter expressions are case insensitive by default.

searchDescendants No string phrase
phrase No string phrase

Response

The successful response returns the collection of assets tracing by upstream lineage relations.

Response body

Example status code responses for this method are shown here. To view the response schemas, you can download the Data Catalog APIs Open API Specification from the Precisely Developer Portal.

Examples
{
  "data": {
    "matched": true,
    "assets": [
      {
        "assetId": "E1Bf46E2da03b19FAe4f2056",
        "matches": 46267797.05907366
      },
      {
        "assetId": "397Ec1DFcb7f718e637b53fE",
        "matches": 61659159.530362695
      }
    ]
  },
  "links": {
    "self": "https://api.cloud.precisely.com/lineage/:assetId/asset-matches"
  }
}
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Bad Request"
}
{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Authentication required"
}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}
{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded"
}
{
  "statusCode": 500,
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}
{
  "statusCode": 503,
  "error": "Service Unavailable",
  "message": "Service temporarily unavailable"
}
{
  "statusCode": 504,
  "error": "Gateway Timeout",
  "message": "Request timeout"
}