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

# GET /suiteDefinitions

`GET /suiteDefinitions`

Lists the Device Advisor test suites you have created.

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

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListSuiteDefinitionsResponse
  - `suiteDefinitionInformationList` SuiteDefinitionInformation[] — An array of objects that provide summaries of information about the suite definitions in the list.
    - `suiteDefinitionId` string — Suite definition ID of the test suite.
    - `suiteDefinitionName` string — Suite name of the test suite.
    - `defaultDevices` DeviceUnderTest[] — Specifies the devices that are under test for the test suite.
      - `thingArn` string — Lists devices thing ARN.
      - `certificateArn` string — Lists devices certificate ARN.
    - `intendedForQualification` boolean — Specifies if the test suite is intended for qualification.
    - `isLongDurationTest` boolean — Verifies if the test suite is a long duration test.
    - `protocol` 'MqttV3_1_1' | 'MqttV5' — Gets the MQTT protocol that is configured in the suite definition.
    - `createdAt` string, date-time — Date (in Unix epoch time) when the test suite was created.
  - `nextToken` string — A token used to get 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)