---
title: "GET /suiteDefinitions/{suiteDefinitionId}"
method: GET
path: "/suiteDefinitions/{suiteDefinitionId}"
---

# GET /suiteDefinitions/{suiteDefinitionId}

`GET /suiteDefinitions/{suiteDefinitionId}`

Gets information about a Device Advisor test suite.

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

## Path parameters

- `suiteDefinitionId` string, required

## Query parameters

- `suiteDefinitionVersion` string

## Response `200`

Success

- GetSuiteDefinitionResponse
  - `suiteDefinitionId` string — Suite definition ID of the suite definition.
  - `suiteDefinitionArn` string — The ARN of the suite definition.
  - `suiteDefinitionVersion` string — Suite definition version of the suite definition.
  - `latestVersion` string — Latest suite definition version of the suite definition.
  - `suiteDefinitionConfiguration` object — Suite configuration of the suite definition.
    - `suiteDefinitionName` string, required — Gets the suite definition name. This is a required parameter.
    - `devices` DeviceUnderTest[] — Gets the devices configured.
      - `thingArn` string — Lists devices thing ARN.
      - `certificateArn` string — Lists devices certificate ARN.
    - `intendedForQualification` boolean — Gets the tests intended for qualification in a suite.
    - `isLongDurationTest` boolean — Verifies if the test suite is a long duration test.
    - `rootGroup` string, required — Gets the test suite root group. This is a required parameter.
    - `devicePermissionRoleArn` string, required — Gets the device permission ARN. This is a required parameter.
    - `protocol` 'MqttV3_1_1' | 'MqttV5' — Sets the MQTT protocol that is configured in the suite definition.
  - `createdAt` string, date-time — Date (in Unix epoch time) when the suite definition was created.
  - `lastModifiedAt` string, date-time — Date (in Unix epoch time) when the suite definition was last modified.
  - `tags` object — Tags attached to the suite definition.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ResourceNotFoundException

---

[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)