---
title: "List rule asset results"
method: GET
path: "/v1/quality/rules/{ruleId}/results"
tags: ["Quality Rules"]
---

# List rule asset results

`GET /v1/quality/rules/{ruleId}/results`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/quality/rules/{ruleId}/results`
- Auth: HTTP bearer

Returns a paginated list of asset-level scoring results for the given rule. Includes score, band, pass/fail counts and paging metadata.

## Path parameters

- `ruleId` string, required

## Query parameters

- `assetId` string
- `page` integer
- `limit` integer

## Response `200`

Rule results page returned successfully

- PageView: Pagination wrapper for paginated API responses containing a list of items and pagination metadata
  - `currentPage` integer: Current page number
  - `items` union[]
    - union: List of items for the current page
      - PipelineListItemView: Represents a summary view of a pipeline including basic metadata and validation status.
        - `createdBy` string
        - `createdDate` string, date-time
        - `error` boolean
        - `id` string
        - `inputStepCount` integer
        - `lastModifiedBy` string
        - `lastModifiedDate` string, date-time
        - `name` string
        - `sourceAssetNamePath` string
        - `sourceAssetTypePath` string
        - `validationStatus` boolean
      - PipelineJobItemView: Represents a single item in the pipeline job list.
        - `comment` string
        - `counts` OperatorRecordCountView[]
          - `count` integer
          - `name` string
          - `type` string
        - `duration` integer
        - `endTime` integer
        - `externalId` string
        - `externalUrl` string
        - `id` string
        - `isScheduled` boolean
        - `pipeline` string
        - `pipelineId` string
        - `recordsProcessed` integer
        - `runConfigId` string
        - `runConfigName` string
        - `sourceAssetNamePath` string
        - `sourceAssetTypePath` string
        - `sourceAssets` AssetView[]
          - `assetNamePath` string
          - `assetTypePath` string
          - `label` string
        - `startTime` integer
        - `status` string
        - `targetAssetNamePath` string
        - `targetAssetTypePath` string
        - `targetAssets` AssetView[]
          - `assetNamePath` string
          - `assetTypePath` string
          - `label` string
        - `user` string
      - PipelineRunConfigListItemView: Represents a summary view of a pipeline run configuration.
        - `compatibilityStatus` boolean
        - `id` string
        - `lastModifiedBy` string
        - `lastModifiedDate` string, date-time
        - `name` string
        - `published` boolean
        - `scheduled` boolean
        - `type` string
      - AssetQualityScoreView: Represents the asset quality score view, including asset details and dimension scores.
        - `assetView` CatalogAssetView: Represents the details of an asset.
          - `assetId` string
          - `assetName` string
          - `assetPath` string
          - `assetType` string
          - `assetTypeId` string
          - `catalogType` string
          - `leaf` boolean
          - `parentId` string
          - `parentName` string
        - `dimensionScores` QualityScoreDimensions: Represents aggregated quality scores, band information, and metric group dimensions for an asset.
          - `aggregatedScore` number, double
          - `dimensions` MetricGroupScore[]
            - `childQualityScores` QualityScoreDetail: Represents detailed quality scores including asset and rule scores.
              - …
            - `id` string
            - `lastRunAt` string, date-time
            - `name` string
            - `score` number, double
            - `scoreBands` BandInfo: Represents a scoring band with label, color, and minimum value for rule evaluation.
              - …
            - `targets` integer
          - `scoreBands` BandInfo: Represents a scoring band with label, color, and minimum value for rule evaluation.
            - `color` string
            - `label` string
            - `minimumValue` number, double
      - ProfileFieldView: Represents information of a field inside a dataset profile.
        - `blankCount` integer
        - `dataType` string
        - `distinctValues` integer
        - `fieldName` string
        - `id` string
        - `invalidCount` integer
        - `maxLength` string
        - `maximumValue` string
        - `minLength` string
        - `minimumValue` string
        - `nullCount` integer
        - `outlierCount` integer
        - `popularity` integer
        - `sampleCount` integer
        - `semanticType` string
        - `validCount` integer
      - RuleAssetView: Represents asset information and its score band information.
        - `assetId` string
        - `assetName` string
        - `assetPath` string
        - `capturedFailedRecords` boolean
        - `catalogType` string
        - `evaluateCount` number, double
        - `failCount` number, double
        - `isSampleAvailable` boolean
        - `lastRunAt` string, date-time
        - `parentAssetId` string
        - `passCount` number, double
        - `score` number, double
        - `scoreBands` BandInfo: Represents a scoring band with label, color, and minimum value for rule evaluation.
          - `color` string
          - `label` string
          - `minimumValue` number, double
        - `totalCount` number, double
      - RuleViewSummary: Summary view of a rule, including key configuration and execution status.
        - `description` string
        - `dimensionId` string
        - `dimensionName` string
        - `enableAutoRun` boolean
        - `id` string
        - `name` string
        - `primaryMetricTypeId` string
        - `ruleType` string
        - `runStatus` RunStatus: Represents the execution status of a rule, including correlation ID, state, and last run timestamp.
          - `correlationId` string
          - `lastRunAt` string, date-time
          - `state` string
        - `scoreClass` string: Score class the rule belongs to.
        - `scoreTarget` string: Identifier of the asset the rule is scored against.
        - `targetAssetCount` integer
        - `targetAssetGroups` string[]
      - ObserverResponse: Observer definition returned by the portal API
        - `createdDate` string, date-time
        - `description` string
        - `id` string
        - `lastModifiedDate` string, date-time
        - `name` string
        - `observations` ObservationConfig[]
          - `alertingConfig` AlertConfig: Configuration that controls how observer alerts and warnings are evaluated
            - `alertLogic` 'AND' | 'OR'
            - `alertingMode` 'HYBRID' | 'CONFIDENCE_ONLY' | 'THRESHOLD_ONLY'
            - `ciAlertPercent` integer
            - `ciWarnPercent` integer
            - `comparisonMethod` 'LAST_VALUE' | 'MOVING_AVERAGE'
            - `sensitivity` integer
            - `thresholdAlertValue` number, double
            - `thresholdDuringLearning` boolean
            - `thresholdType` 'PERCENT' | 'RELATIVE' | 'ABSOLUTE'
            - `thresholdWarnValue` number, double
            - `trainingWindow` TrainingWindow: Training window used to establish observer alert baselines
              - …
            - `warnEnabled` boolean
            - `warnLogic` 'AND' | 'OR'
          - `evaluationType` 'NUMERIC' | 'TEMPORAL' | 'STRUCTURAL'
          - `excludedColumns` ExcludeColumn[]
            - `name` string
          - `metricTypeId` string
          - `observationKind` string
          - `significanceFilterValue` number, double
          - `significanceMode` 'PERCENTAGE_OF_VALUE' | 'ABSOLUTE_POINT'
          - `sourcingMode` 'SCHEDULE' | 'NONE'
          - `tags` string[]
          - `timeUnit` 'HOURS' | 'DAYS' | 'WEEKS'
          - `triggers` SchemaConfig[]
            - `enabled` boolean
            - `severity` 'WARN' | 'ALERT'
            - `triggerType` 'TABLE_DELETED' | 'COLUMN_DELETED' | 'COLUMN_ADDED' | 'TYPE_CHANGED' | 'COLUMN_RENAMED' | 'COLUMN_ORDER' | 'NULLABLE_CHANGED'
        - `status` 'ACTIVE' | 'INACTIVE' | 'PAUSED'
        - `targetAssetGroupId` string
        - `targeting` union
          - AssetGroupConfig: Observer targeting configuration for an asset group
            - `type` string
            - `assetGroupId` string
          - AssetIdConfig: Observer targeting configuration for a single asset
            - `type` string
            - `assetId` string
      - ObservationTypeView: Supported observation type and its available alerting modes
        - `allowedAlertingModes` string[]
        - `description` string
        - `observationType` string
      - AlertResponse: Alert emitted by an observer for an evaluated metric value
        - `alert` AlertDetail: Detailed alert evaluation data returned with an observer alert
          - `alertTimestamp` string, date-time
          - `bandSnapshot` BandSnapshot: Snapshot of the expected observer band bounds at alert evaluation time
            - `expectedValue` number, double
            - `lowerBound` number, double
            - `upperBound` number, double
          - `evaluations` AlertItemView[]
            - `confidenceMetrics` unknown[]
              - …
            - `configType` string
            - `currentValue` number, double
            - `direction` string
            - `drifts` unknown[]
              - …
            - `evaluationType` string
            - `level` string
            - `metricKey` string
            - `metrics` unknown[]
              - …
            - `thresholdBreached` number, double
            - `thresholdMetrics` unknown[]
              - …
          - `metricTimestamp` string, date-time
          - `observerId` string
          - `tenantId` string
        - `assetId` string
        - `createdBy` string
        - `createdDate` string, date-time
        - `evaluationType` 'NUMERIC' | 'TEMPORAL' | 'STRUCTURAL'
        - `history` AlertHistoryView[]
          - `alertId` string
          - `createdBy` string
          - `createdDate` string, date-time
          - `details` union
            - AlertCreatedDetailView: Details for the ALERT_CREATED event — a snapshot of the alert at the moment it was first raised
              - …
            - AssignedDetailView: Details for the ASSIGNED event
              - …
            - CommentAddedDetailView: Details for the COMMENT_ADDED event — a comment added without an accompanying state transition
              - …
            - StateChangedDetailView: Details for the STATE_CHANGED event, optionally with a dismiss reason and/or comment
              - …
            - ValueExcludedDetailView: Details for the VALUE_EXCLUDED event
              - …
          - `eventType` 'ALERT_CREATED' | 'STATE_CHANGED' | 'COMMENT_ADDED' | 'ASSIGNED' | 'VALUE_EXCLUDED'
          - `id` string
        - `id` string
        - `lastModifiedBy` string
        - `lastModifiedDate` string, date-time
        - `metricTypeId` string
        - `metricValueId` string
        - `observationKind` string
        - `observerId` string
        - `severity` 'WARN' | 'CRITICAL' | 'ALERT'
        - `state` 'NEW' | 'OPEN' | 'IN_PROGRESS' | 'CLOSED'
        - `tags` string[]
        - `timestamp` string, date-time
  - `pageSize` integer: Number of items per page
  - `totalItems` integer: Total number of items across all pages
  - `totalPages` integer: Total number of pages available based on page size and total items

## Other responses

- `400`: Invalid request parameters
- `404`: Rule not found
- `500`: Internal server error

---

[API](https://skmtc.dev/precisely/apis/verify-api-portal.md) · [All operations](https://skmtc.dev/precisely/apis/verify-api-portal/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/verify-api-portal/revisions/380735465266?raw)
