---
title: "Get quality scores for an asset (latest / history)"
method: GET
path: "/v2/quality/scores/{assetId}"
tags: ["Quality Scores"]
---

# Get quality scores for an asset (latest / history)

`GET /v2/quality/scores/{assetId}`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v2/quality/scores/{assetId}`
- Auth: HTTP bearer

Returns paginated quality scores for a single asset. **Latest mode** (no date params): returns the single most recent score record, sorted by effectiveDate DESC. **History mode** (fromDate provided): returns all records within the date range, sorted by effectiveDate ASC. Optional **dimensionId** narrows results to a specific quality dimension.

## Path parameters

- `assetId` string, required

## Query parameters

- `dimensionId` string
- `fromDate` string, date
- `toDate` string, date
- `page` integer
- `limit` integer

## Response `200`

Successfully retrieved asset quality scores.

- ScoresQueryResponseView: Paginated response containing quality score items and pagination metadata for v2 quality score queries.
  - `currentPage` integer
  - `items` ScoreItem[]
    - `assetId` string
    - `dimensionId` string
    - `effectiveDate` string
    - `score` number, double
    - `scoreBand` BandInfo[]
      - `color` string
      - `label` string
      - `minimumValue` number, double
  - `pageSize` integer
  - `totalItems` integer
  - `totalPages` integer

## Other responses

- `400`: Invalid request parameters — MISSING_REQUIRED_FILTER | INVALID_FILTER_VALUE | INVALID_DATE_RANGE | INVALID_DATE_FORMAT | INVALID_PAGINATION
- `404`: Asset not found for the given ID
- `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)