Get quality scores for an asset (v2) - Precisely Data Integrity Suite

curl -X GET "/v2/quality/scores/{assetId}" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

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

import json
import requests

url = "/v2/quality/scores/{assetId}"
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/scores/{assetId}", 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))
}

Behavior: Returns the most recent quality score for the specified asset and dimension when fromDate is not provided.

{
  "items": [
    {
      "assetId": "68c289f1c78ac464af9a3fd0",
      "dimensionId": "00000000a00aa0001aaa0a1a",
      "score": 88.5,
      "scoreBand": [
        {
          "label": "Excellent",
          "color": "#2ECC71",
          "minimumValue": 80.0
        },
        {
          "label": "Good",
          "color": "#F39C12",
          "minimumValue": 60.0
        },
        {
          "label": "Poor",
          "color": "#E74C3C",
          "minimumValue": 0.0
        }
      ],
      "effectiveDate": "2024-03-01"
    }
  ],
  "totalItems": 1,
  "totalPages": 1,
  "currentPage": 1,
  "pageSize": 10
}

Behavior: Returns historical quality scores when fromDate is provided and toDate is omitted. The endpoint treats toDate as today.

{
  "items": [
    {
      "assetId": "68c289f1c78ac464af9a3fd0",
      "dimensionId": "00000000a00aa0001aaa0a1a",
      "score": 87.9,
      "scoreBand": [
        {
          "label": "Excellent",
          "color": "#2ECC71",
          "minimumValue": 80.0
        },
        {
          "label": "Good",
          "color": "#F39C12",
          "minimumValue": 60.0
        },
        {
          "label": "Poor",
          "color": "#E74C3C",
          "minimumValue": 0.0
        }
      ],
      "effectiveDate": "2024-02-26"
    },
    {
      "assetId": "68c289f1c78ac464af9a3fd0",
      "dimensionId": "00000000a00aa0001aaa0a1a",
      "score": 84.1,
      "scoreBand": [
        {
          "label": "Excellent",
          "color": "#2ECC71",
          "minimumValue": 80.0
        },
        {
          "label": "Good",
          "color": "#F39C12",
          "minimumValue": 60.0
        },
        {
          "label": "Poor",
          "color": "#E74C3C",
          "minimumValue": 0.0
        }
      ],
      "effectiveDate": "2024-03-01"
    }
  ],
  "totalItems": 2,
  "totalPages": 1,
  "currentPage": 1,
  "pageSize": 10
}

Behavior: Returns historical quality scores within the requested date range when both fromDate and toDate are provided.

{
  "items": [
    {
      "assetId": "68c289f1c78ac464af9a3fd0",
      "dimensionId": "00000000a00aa0001aaa0a1a",
      "score": 86.4,
      "scoreBand": [
        {
          "label": "Excellent",
          "color": "#2ECC71",
          "minimumValue": 80.0
        },
        {
          "label": "Good",
          "color": "#F39C12",
          "minimumValue": 60.0
        },
        {
          "label": "Poor",
          "color": "#E74C3C",
          "minimumValue": 0.0
        }
      ],
      "effectiveDate": "2024-01-15"
    },
    {
      "assetId": "68c289f1c78ac464af9a3fd0",
      "dimensionId": "00000000a00aa0001aaa0a1a",
      "score": 83.2,
      "scoreBand": [
        {
          "label": "Excellent",
          "color": "#2ECC71",
          "minimumValue": 80.0
        },
        {
          "label": "Good",
          "color": "#F39C12",
          "minimumValue": 60.0
        },
        {
          "label": "Poor",
          "color": "#E74C3C",
          "minimumValue": 0.0
        }
      ],
      "effectiveDate": "2024-01-20"
    }
  ],
  "totalItems": 2,
  "totalPages": 1,
  "currentPage": 1,
  "pageSize": 10
}

Behavior: Returns an empty list when no scores match the provided filters.

{
  "items": [],
  "totalItems": 0,
  "totalPages": 0,
  "currentPage": 1,
  "pageSize": 10
}

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/scores/68c289f1c78ac464af9a3fd0",
  "errorCode": "DIS-QUALITY-SCORES-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": "Asset not found for the given ID",
  "instance": "https://verify-api-portal-dev.dqcore.cloud.precisely.services/v2/quality/scores/68c289f1c78ac464af9a3fd0",
  "errorCode": "DIS-QUALITY-SCORES-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/scores/68c289f1c78ac464af9a3fd0",
  "errorCode": "DIS-QUALITY-SCORES-SVC-0001"
}