Retrieves rule asset results (latest / history).
- 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).
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"
}