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

# GET /v1/orchestrator/assessment_tools

`GET /v1/orchestrator/assessment_tools`

Lists all assessment tools assessing evidences for the metric given by the
 passed metric id

## Query parameters

- `pageSize` integer
- `pageToken` string
- `orderBy` string
- `asc` boolean

## Response `200`

OK

- ListAssessmentToolsResponse
  - `tools` AssessmentTool[]
    - `id` string
    - `name` string, required
    - `description` string
    - `availableMetrics` string[], required — a list of metrics that this tool can assess, referred by their ids
  - `nextPageToken` string

## Other responses

- `default` — Default error response

## Changes

- **2024-09-17** `c04ff2fe305c` — 2 info
  - the response property `tools/items/availableMetrics` became required for the status `200`
  - the response property `tools/items/name` became required for the status `200`
- **2024-06-03** `9dcdf935e80a` — 5 warning
  - deleted the `query` request parameter `filter.cloudServiceId`
  - deleted the `query` request parameter `filter.compliant`
  - deleted the `query` request parameter `filter.metricId`
  - deleted the `query` request parameter `filter.metricIds`
  - …1 more
- **2023-06-06** `61f295ad12bb` — 1 info
  - added the new optional `query` request parameter `filter.toolId`
- **2023-04-04** `412a107aaeaa` — 1 warning, 4 info
  - deleted the `query` request parameter `filterMetricId`
  - added the new optional `query` request parameter `filter.cloudServiceId`
  - added the new optional `query` request parameter `filter.compliant`
  - added the new optional `query` request parameter `filter.metricId`
  - …1 more
- **2022-12-09** `4061cf3eaf37` — 1 warning, 1 info
  - deleted the `query` request parameter `metricId`
  - added the new optional `query` request parameter `filterMetricId`

[Full history](https://skmtc.dev/clouditor/apis/orchestrator-api/changes/v1/orchestrator/assessment_tools/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)