---
title: "GET /v1/orchestrator/assessment_results"
method: GET
path: "/v1/orchestrator/assessment_results"
tags: ["Orchestrator"]
---

# GET /v1/orchestrator/assessment_results

`GET /v1/orchestrator/assessment_results`

List all assessment results. Part of the public API, also exposed as REST.

## Query parameters

- `filter.targetOfEvaluationId` string
- `filter.compliant` boolean
- `filter.metricIds` string[]
- `filter.metricId` string
- `filter.toolId` string
- `filter.assessmentResultIds` string[]
- `latestByResourceId` boolean
- `pageSize` integer
- `pageToken` string
- `orderBy` string
- `asc` boolean

## Response `200`

OK

- ListAssessmentResultsResponse
  - `results` AssessmentResult[]
    - `id` string, required — Assessment result id
    - `createdAt` string, date-time, required — Time of assessment
    - `metricId` string, required — Reference to the metric the assessment was based on
    - `metricConfiguration` MetricConfiguration, required — Defines the operator and a target value for an individual metric
      - `operator` string, required — The operator to compare the metric, such as == or >
      - `targetValue` unknown, required
      - `isDefault` boolean, required — Whether this configuration is a default configuration
      - `updatedAt` string, date-time — The last time of update
      - `metricId` string, required — The metric this configuration belongs to
      - `targetOfEvaluationId` string, required — The target of evaluation this configuration belongs to
    - `compliant` boolean — Compliant case: true or false
    - `evidenceId` string, required — Reference to the last assessed evidence
    - `resourceId` string, required — Reference to the resource of the assessed evidence
    - `resourceTypes` string[], required — Resource types
    - `complianceComment` string, required — ComplianceComment contains a human readable description on the reason for (non)-compliance.
    - `complianceDetails` ComparisonResult[] — ComplianceDetails contains machine-readable details about which comparisons lead to a (non)-compliance.
      - `property` string, required — Property is the property that was compared
      - `value` unknown, required
      - `operator` string, required — Operator is the operator used in the comparison
      - `targetValue` unknown, required
      - `success` boolean, required — Success is true, if the comparison was sucessful
    - `targetOfEvaluationId` string, required — The target of evaluation which this assessment result belongs to
    - `toolId` string, required — Reference to the tool which provided the assessment result
    - `historyUpdatedAt` string, date-time, required — The time of the last update of the assessment result history field
    - `history` Record[], required — Stores the history of evidence IDs and timestamps for evidence that have the same content as the evidence used for this assessment result.
      - `evidenceId` string, required
      - `evidenceRecordedAt` string, date-time, required
  - `nextPageToken` string

## Other responses

- `default` — Default error response

## Changes

- **2025-07-16** `36dbd5beec62` — 1 breaking, 3 info
  - removed the required property `results/items/timestamp` from the response with the `200` status
  - added the required property `results/items/createdAt` to the response with the `200` status
  - added the required property `results/items/history` to the response with the `200` status
  - added the required property `results/items/historyUpdatedAt` to the response with the `200` status
- **2025-03-27** `f2db05790701` — 2 breaking, 1 warning, 3 info
  - removed the required property `results/items/certificationTargetId` from the response with the `200` status
  - removed the required property `results/items/metricConfiguration/allOf[#/components/schemas/MetricConfiguration]/certificationTargetId` from the response with the `200` status
  - deleted the `query` request parameter `filter.certificationTargetId`
  - added the new optional `query` request parameter `filter.targetOfEvaluationId`
  - …2 more
- **2025-01-08** `2b79660c20a0` — 2 warning, 17 info
  - removed the optional property `results/items/nonComplianceComments` from the response with the `200` status
  - removed the optional property `results/items/nonComplianceDetails` from the response with the `200` status
  - added the new optional `query` request parameter `filter.assessmentResultIds`
  - added the optional property `results/items/complianceDetails` to the response with the `200` status
  - …15 more
- …earlier changes not shown

[Full history](https://skmtc.dev/clouditor/apis/orchestrator-api/changes/v1/orchestrator/assessment_results/get.md)

---

[API](https://skmtc.dev/clouditor/apis/orchestrator-api.md) · [All operations](https://skmtc.dev/clouditor/apis/orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clouditor/orchestrator-api/revisions/6f8ae69f4eb5/schema)