---
title: "GET /suiteRuns"
method: GET
path: "/suiteRuns"
---

# GET /suiteRuns

`GET /suiteRuns`

Lists runs of the specified Device Advisor test suite. You can list all runs of the test suite, or the runs of a specific version of the test suite.

Requires permission to access the [ListSuiteRuns](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Query parameters

- `suiteDefinitionId` string
- `suiteDefinitionVersion` string
- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListSuiteRunsResponse
  - `suiteRunsList` SuiteRunInformation[] — An array of objects that provide summaries of information about the suite runs in the list.
    - `suiteDefinitionId` string — Suite definition ID of the suite run.
    - `suiteDefinitionVersion` string — Suite definition version of the suite run.
    - `suiteDefinitionName` string — Suite definition name of the suite run.
    - `suiteRunId` string — Suite run ID of the suite run.
    - `createdAt` string, date-time — Date (in Unix epoch time) when the suite run was created.
    - `startedAt` string, date-time — Date (in Unix epoch time) when the suite run was started.
    - `endAt` string, date-time — Date (in Unix epoch time) when the suite run ended.
    - `status` 'PASS' | 'FAIL' | 'CANCELED' | 'PENDING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'PASS_WITH_WARNINGS' | 'ERROR' — Status of the suite run.
    - `passed` integer — Number of test cases that passed in the suite run.
    - `failed` integer — Number of test cases that failed in the suite run.
  - `nextToken` string — A token to retrieve the next set of results.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException

---

[API](https://skmtc.net/aws/apis/iotdeviceadvisor.md) · [All operations](https://skmtc.net/aws/apis/iotdeviceadvisor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotdeviceadvisor/versions/9a6cea03b52e/schema)