---
title: "GET /v1/evaluation/results"
method: GET
path: "/v1/evaluation/results"
tags: ["Evaluation"]
---

# GET /v1/evaluation/results

`GET /v1/evaluation/results`

List all evaluation results that the user can access. It can further be
 restricted by various filtering options. Part of the public API, also
 exposed as REST.

## Query parameters

- `filter.targetOfEvaluationId` string
- `filter.catalogId` string
- `filter.controlId` string
- `filter.subControls` string
- `filter.parentsOnly` boolean
- `filter.validManualOnly` boolean
- `latestByControlId` boolean
- `pageSize` integer
- `pageToken` string
- `orderBy` string
- `asc` boolean

## Response `200`

OK

- ListEvaluationResultsResponse
  - `results` EvaluationResult[]
    - `id` string, required — Evaluation result id
    - `targetOfEvaluationId` string — The Target of Evaluation ID the evaluation belongs to
    - `auditScopeId` string — The Audit Scope ID the evaluation belongs to
    - `controlId` string — The control id the evaluation was based on
    - `controlCategoryName` string — The category the evaluated control belongs to
    - `controlCatalogId` string — The catalog the evaluated control belongs to
    - `parentControlId` string — Optionally, specifies the parent control ID, if this is a sub-control
    - `status` 'EVALUATION_STATUS_UNSPECIFIED' | 'EVALUATION_STATUS_COMPLIANT' | 'EVALUATION_STATUS_COMPLIANT_MANUALLY' | 'EVALUATION_STATUS_NOT_COMPLIANT' | 'EVALUATION_STATUS_NOT_COMPLIANT_MANUALLY' | 'EVALUATION_STATUS_PENDING', enum, required — Evaluation status
    - `timestamp` string, date-time, required — Time of evaluation
    - `assessmentResultIds` string[], required — List of assessment results because of which the evaluation status is compliant or not compliant
    - `comment` string
    - `validUntil` string, date-time — Optional, but required if the status is one of the "manually" ones. This denotes how long the (manual) created evaluation result is valid. During this time, no automatic results are generated for the specific control.
  - `nextPageToken` string

## Other responses

- `default` — Default error response

## Changes

> 9 revisions in range; 1 could not be searched.

- **2025-01-08** `837ea0d4ed5c` — 1 warning, 4 info
  - removed the optional property `results/items/failingAssessmentResultIds` from the response with the `200` status
  - the response property `results/items/id` became required for the status `200`
  - the response property `results/items/status` became required for the status `200`
  - the response property `results/items/timestamp` became required for the status `200`
  - …1 more
- **2025-01-08** `020d48e13d66` — 1 info
  - added the optional property `results/items/auditScopeId` to the response with the `200` status
- **2024-10-01** `1c4252633c35` — 2 warning, 2 info
  - deleted the `query` request parameter `filter.cloudServiceId`
  - removed the optional property `results/items/cloudServiceId` from the response with the `200` status
  - added the new optional `query` request parameter `filter.certificationTargetId`
  - added the optional property `results/items/certificationTargetId` to the response with the `200` status
- …earlier changes not shown

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

---

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