List rule results for an asset (v2) - 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

Retrieves rule asset results (latest / history).

Returns paginated quality rule execution results for a single asset and rule.
  • Latest mode (no date parameters): returns the most recent result per metric type, sorted by effectiveDate (descending).
  • History mode (fromDate provided): returns all results within the date range, sorted by effectiveDate (ascending).

HTML

GET https://hostname /v2/quality/rules/{ruleId}/results

Request Parameters

Path parameters

Name Type Required Description
ruleId string Yes Rule Id of the rule to retrieve.

Query parameters

Name Type Required Description
assetId string Yes Identifier for an asset.
fromDate string No Starts of the requested date range, inclusive (yyyy-MM-dd). Omit for latest mode.
toDate string No End of the requested date range, inclusive (yyyy-MM-dd). Defaults to today when fromDate is provided.
page integer No Page number.
limit integer No Number of results per page, 1–100 (default: 10).

Example URL

GET https://hostname/v2/quality/rules/6929364c4e818705c17e7cd3/results?assetId=68c289f1c78ac464af9a3fd0&fromDate=2024-01-01&toDate=2024-03-31&page=1&limit=10

Request Body

No request body.

Request Examples

Each example shows how to call this endpoint with the documented method, URL, headers, and request body format.


curl -X GET "/v2/quality/rules/{ruleId}/results" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

fetch("/v2/quality/rules/{ruleId}/results", {
  method: "GET",
  headers: {
        "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
  
})
.then(res => res.json())
.then(data => console.log(data));

import json
import requests

url = "/v2/quality/rules/{ruleId}/results"
headers = {
    "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
payload = None

response = requests.get(url, headers=headers)
print(response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := http.NoBody
	req, _ := http.NewRequest("GET", "/v2/quality/rules/{ruleId}/results", body)
	req.Header.Set("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...")
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body2, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body2))
}

Response

200 - Request successful.

Schema: RuleResultsQueryResponse (object)

Name Type Required Description
items array[object] No Collection of values returned by this operation.
totalItems integer No totalItems value returned for a successful response.
totalPages integer No totalPages value returned for a successful response.
currentPage integer No currentPage value returned for a successful response.
pageSize integer No pageSize value returned for a successful response.

items[] item fields

Name Type Required Description
assetId string No Unique identifier returned for this resource.
ruleId string No Unique identifier returned for this resource.
effectiveDate string No effectiveDate value returned for a successful response.
score number No score value returned for a successful response.
passCount integer No passCount value returned for a successful response.
failCount integer No failCount value returned for a successful response.
evaluateCount integer No evaluateCount value returned for a successful response.
totalCount integer No totalCount value returned for a successful response.
scoreBand array[object] No Collection of values returned by this operation.

400 - Invalid request parameters.

Schema: ProblemDetail (object)

Name Type Required Description
type string No type value returned in this response.
title string No title value returned in this response.
status integer No Current processing status for this response.
detail string No Human-readable details returned by the service.
instance string No instance value returned in this response.
properties object No Structured object returned in the response payload.

404 - Identifier for a rule or asset not found for given.

Schema: ProblemDetail (object)

Name Type Required Description
type string No type value returned in this response.
title string No title value returned in this response.
status integer No Current processing status for this response.
detail string No Human-readable details returned by the service.
instance string No instance value returned in this response.
properties object No Structured object returned in the response payload.

500 - Internal server error.

Schema: ProblemDetail (object)

Name Type Required Description
type string No type value returned in this response.
title string No title value returned in this response.
status integer No Current processing status for this response.
detail string No Human-readable details returned by the service.
instance string No instance value returned in this response.
properties object No Structured object returned in the response payload.

Success responses

Behavior: Returns the latest rule result of a particular asset when fromDate and toDate are not provided.

{
  "items": [
    {
      "lastRunAt": "2026-04-01T10:48:52.209Z",
      "score": 0.96115,
      "passCount": 19223,
      "totalCount": 20000,
      "failCount": 777,
      "evaluateCount": 20000,
      "scoreBand": "Good"
    }
  ],
  "totalItems": 1,
  "totalPages": 1,
  "currentPage": 1,
  "pageSize": 10
}

Behavior: Returns historical rule results when fromDate is provided and toDate is not provided. The endpoint treats toDate as today's date.

{
  "items": [
    {
      "lastRunAt": "2026-04-01T10:48:52.209Z",
      "score": 0.96115,
      "passCount": 19223,
      "totalCount": 20000,
      "failCount": 777,
      "evaluateCount": 20000,
      "scoreBand": "Good"
    },
    {
      "lastRunAt": "2026-03-15T09:30:12.115Z",
      "score": 0.9482,
      "passCount": 18964,
      "totalCount": 20000,
      "failCount": 1036,
      "evaluateCount": 20000,
      "scoreBand": "Good"
    },
    {
      "lastRunAt": "2026-02-28T08:12:45.782Z",
      "score": 0.9325,
      "passCount": 18650,
      "totalCount": 20000,
      "failCount": 1350,
      "evaluateCount": 20000,
      "scoreBand": "Fair"
    }
  ],
  "totalItems": 3,
  "totalPages": 1,
  "currentPage": 1,
  "pageSize": 10
}

Behavior: Returns historical rule results within the specified date range when both fromDate and toDate are provided.

{
  "items": [
    {
      "lastRunAt": "2026-03-15T09:30:12.115Z",
      "score": 0.9482,
      "passCount": 18964,
      "totalCount": 20000,
      "failCount": 1036,
      "evaluateCount": 20000,
      "scoreBand": "Good"
    },
    {
      "lastRunAt": "2026-03-01T07:05:33.441Z",
      "score": 0.9398,
      "passCount": 18796,
      "totalCount": 20000,
      "failCount": 1204,
      "evaluateCount": 20000,
      "scoreBand": "Fair"
    }
  ],
  "totalItems": 2,
  "totalPages": 1,
  "currentPage": 1,
  "pageSize": 10
}

Error responses

What to do: Review path, query, header, and body values. Correct invalid fields and retry the request.

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid or malformed request",
  "instance": "https://verify-api-portal-dev.dqcore.cloud.precisely.services/v2/quality/rules/689d9917437bd1d494d6b/results",
  "errorCode": "DIS-QUALITY-RULES-USR-0001"
}

What to do: Confirm the resource identifier and endpoint path, then retry with a valid identifier.

{
  "type": "about:blank",
  "title": "Not Found",
  "status": 404,
  "detail": "Rule or asset not found for given ID",
  "instance": "https://verify-api-portal-dev.dqcore.cloud.precisely.services/v2/quality/rules/689d9917437bd1d494d6b/results",
  "errorCode": "DIS-QUALITY-RULES-USR-0003"
}

What to do: Retry after a short delay. If the issue persists, collect error identifiers from the payload and contact support.

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred on the server",
  "instance": "https://verify-api-portal-dev.dqcore.cloud.precisely.services/v2/quality/rules/689d9917437bd1d494d6b/results",
  "errorCode": "DIS-QUALITY-RULES-SVC-0001"
}