Trust scores

Download OpenAPI spec

The Qlik Trust Score™ helps you answer the question “How trustable is my dataset?”. This global quality indicator aggregates several metrics into a single and easy-to-understand score, providing visibility on the health of individual datasets through an overall score and a per-axis and per-metric breakdown.

Retrieve Trust Scores in bulk

Returns the current Trust Score for up to 100 datasets in a single request. Each result includes the overall score, per-axis breakdown (weight, score, enabled state), and per-metric details. Datasets with no computed Trust Score are omitted from the response. Requires dataset:read and dataquality:read permissions.

Facts

Rate limit Tier 2 (100 requests per minute)

Request Body

Required

List of dataset IDs to retrieve Trust Scores for. Maximum 100 IDs per request.

  • application/jsonobject

    Request body for batch-filtering Trust Score results by dataset IDs.

    Show application/json properties
    • datasetIdsarray of strings
      Required

      List of dataset IDs to retrieve Trust Scores for. Maximum 100 IDs per request.

      minItems = 1, maxItems = 100

Responses

200

Trust Score results for the requested datasets. Datasets with no computed Trust Score are omitted.

  • application/jsonobject

    Trust Score results for the requested datasets. Datasets with no computed Trust Score are omitted.

    Show application/json properties
    • dataarray of objects
      Required

      List of Trust Score results, one entry per dataset found.

      Show data properties
      • axesarray of objects
        Required

        Per-axis breakdown of the Trust Score.

        Show axes properties
        • idstring
          Required

          Defines the axis of the Trust Score.

          Can be one of: "VALIDITY""COMPLETENESS""USAGE""DISCOVERABILITY""ACCURACY""DIVERSITY""TIMELINESS"

        • scorenumber

          Computed score for this axis [0, 100]. Omitted when axis is not applicable.

        • weightinteger
          Required

          Defines the weight of the axis or metric in the Trust Score.

          minimum = 0, maximum = 100, format = int32

        • enabledboolean

          Whether this axis is enabled in the tenant configuration. Disabled axes have a weight of 0 and do not affect the overall score.

        • metricsarray of objects
          Required

          Per-metric breakdown contributing to this axis score.

          Show metrics properties
          • idstring
            Required

            Defines the metric of the axis in the Trust Score.

            Can be one of: "VALIDITY_QUALITY""COMPLETENESS_QUALITY""USAGE_APPS""USAGE_APP_VIEWS""DISCOVERABILITY_DESCRIPTION""DISCOVERABILITY_TAGS""DISCOVERABILITY_ACTIVATED""DISCOVERABILITY_FIELD_DESCRIPTION""DISCOVERABILITY_FIELD_TAGS""ACCURACY_QUALITY""DIVERSITY_SOURCE""DIVERSITY_VOLUME""DIVERSITY_EVENNESS""TIMELINESS_FRESHNESS"

          • scorenumber

            Computed score for this metric [0, 100]. Omitted when metric is not applicable.

          • weightinteger
            Required

            Defines the weight of the axis or metric in the Trust Score.

            minimum = 0, maximum = 100, format = int32

        • applicableboolean

          Whether this axis is applicable for the dataset. An axis may be enabled but not applicable (for example, TIMELINESS when no freshness threshold is set).

        • previousScorenumber

          Axis score from the previous computation, for change tracking.
      • scorenumber
        Required

        Overall weighted Trust Score across all enabled axes [0, 100].

      • datasetIdstring
        Required

        Unique identifier of the dataset this score belongs to.

      • updatedAtstring
        Required

        Timestamp of the last Trust Score computation for this dataset.

        format = "date-time"

      • previousScorenumber

        Overall Trust Score from the previous computation, for change tracking.

400

The request is in incorrect format.

  • application/jsonobject
    Show application/json properties
    • errorsarray of objects
      Show errors properties
      • codestring
      • titlestring
      • detailstring
      • statusstring
    • traceIdstring

401

User does not have valid authentication credentials.

  • application/jsonobject
    Show application/json properties
    • errorsarray of objects
      Show errors properties
      • codestring
      • titlestring
      • detailstring
      • statusstring
    • traceIdstring

403

User does not have access to the resource.

  • application/jsonobject
    Show application/json properties
    • errorsarray of objects
      Show errors properties
      • codestring
      • titlestring
      • detailstring
      • statusstring
    • traceIdstring

500

Internal Server Error.

  • application/jsonobject
    Show application/json properties
    • errorsarray of objects
      Show errors properties
      • codestring
      • titlestring
      • detailstring
      • statusstring
    • traceIdstring

503

Requested service is not available.

  • application/jsonobject
    Show application/json properties
    • errorsarray of objects
      Show errors properties
      • codestring
      • titlestring
      • detailstring
      • statusstring
    • traceIdstring
POST /api/data-governance/trust-scores/results/data-sets/actions/filter 
// qlik-api has not implemented support for `POST /api/data-governance/trust-scores/results/data-sets/actions/filter` yet.
// In the meantime, you can use fetch like this:


const response = await fetch(
  '/api/data-governance/trust-scores/results/data-sets/actions/filter',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      datasetIds: [
        'Jjk5NNHiUObQe8xTyeLgP5nQjKTpEr8R',
      ],
    }),
  },
)
# qlik-cli has not implemented support for POST /api/data-governance/trust-scores/results/data-sets/actions/filter yet.
curl "https://{tenant}.{region}.qlikcloud.com/api/data-governance/trust-scores/results/data-sets/actions/filter" \
-X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '{"datasetIds":["Jjk5NNHiUObQe8xTyeLgP5nQjKTpEr8R"]}'

Example Response

{
  "data": [
    {
      "axes": [
        {
          "id": "TIMELINESS",
          "score": 42,
          "weight": 50,
          "enabled": true,
          "metrics": [
            {
              "id": "TIMELINESS_FRESHNESS",
              "score": 42,
              "weight": 50
            }
          ],
          "applicable": true,
          "previousScore": 42
        }
      ],
      "score": 42,
      "datasetId": "Jjk5NNHiUObQe8xTyeLgP5nQjKTpEr8R",
      "updatedAt": "2018-03-20T09:12:28Z",
      "previousScore": 42
    }
  ]
}