Retrieve asset types - 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

Retrieve a list of Asset Types specified by filter criteria.

HTTP

GET https://hostname/v2/catalog/asset-types

Request

Query parameters

Parameter Required Type Description
filter Yes string

Filter the results by specifying one or more filters in this format:

field:operator(value):index

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.

sort No string

Sort the results by a field in ascending or descending order.

asc(field)

or

desc(field)

Specify asc to sort in ascending order (0–9, a–z) or desc to sort in descending order (z–a, 9–0). Specify multiple sort fields with multiple sort parameters. Sorting is applied in the same order that sort query parameters are ordered.

Example: To first sort by field1 in ascending order and then by field2 in descending order, use two sort expressions:
sort=asc(field1)&sort=desc(field2)
offset No number

The number of records to skip before returning results. The minimum is 0. The default is none (0).
limit No number

The number of records to return per page. The minimum is 1.
includeTotal No boolean

Return a count of the total number of records that match the specified filter expression regardless of the number of number of records returned in the response page.

  • True — Return the total count of records that match the specified filter.
  • False — Do not return the count (default).

The count is returned by the total property in the response body. If the totalOverflow property is set to true in the response body, then the total count is an estimate that may exceed the actual number of records returned by the search.
search No boolean

Use search engine to perform the filter operation.

  • True — Use search engine.
  • False — Do not use search engine (default)

The search engine:

  • Performs a case insensitive search.
  • May improve performance for complex filter expressions, such as those that use the contains operator.
  • When search and includeTotal are both set to true, the search engine will always return the total number of records that match the specified filter expression.
Note: In rare cases, the search=true parameter setting may not return recently created or updated records.
sections No string

Specifies properties to be included in the response. List properties names separated by commas. The asset id is always included in the response. All properties are included if this parameter is not included in the query string.

Example: The query string parameter setting sections=name,class,displayFormat returns only id and class, and displayFormat in the result body.

Response

The successful response returns the collection of asset types that match the filter criteria.

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": [
    {
      "id": "665955c93aa0fa56e23a4e10",
      "class": "Business",
      "name": "GOV-32948",
      "description": "This is a test",
      "xref": [
        "02f2cc9c1e67"
      ],
      "contexts": [],
      "properties": [
        {
          "name": "Name",
          "label": "Name",
          "type": "Text",
          "definition": {
            "text": {
              "allowRichText": true,
              "defaultValue": "false",
              "validation": {
                "regex": "",
                "minLength": 0,
                "maxLength": 0
              }
            }
          },
          "requirement": "Optional",
          "category": "General",
          "display": {
            "show": true,
            "showIfEmpty": true,
            "showInColumn": true
          },
          "isSystemProperty": false
        }
      ],
      "levels": [
        {
          "levelNumber": 1,
          "levelName": "One"
        }
      ],
      "maximumDepth": 1,
      "state": "Active",
      "assetCount": 0,
      "createdBy": "Sample User",
      "createdAt": "2024-05-31T04:44:57.126Z",
      "updatedAt": "2024-05-31T04:44:57.126Z",
      "updatedBy": "Sample User",
      "overridability": "All",
      "displayFormat": "{Name}",
      "abstract": false
    }
  ],
  "links": {
    "self": "https://api.cloud.precisely.com/asset-types"
  }
}
{
  "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"
}