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

# GET /devices

`GET /devices`

Returns a list of thin client devices.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListDevicesResponse
  - `devices` DeviceSummary[] — Describes devices.
    - `id` string — The ID of the device.
    - `serialNumber` string — The hardware serial number of the device.
    - `name` string, password — The name of the device.
    - `model` string — The model number of the device.
    - `environmentId` string — The ID of the environment the device is associated with.
    - `status` 'REGISTERED' | 'DEREGISTERING' | 'DEREGISTERED' | 'ARCHIVED' — The status of the device.
    - `currentSoftwareSetId` string — The ID of the software set currently installed on the device.
    - `desiredSoftwareSetId` string — The ID of the software set which the device has been set to.
    - `pendingSoftwareSetId` string — The ID of the software set that is pending to be installed on the device.
    - `softwareSetUpdateSchedule` 'USE_MAINTENANCE_WINDOW' | 'APPLY_IMMEDIATELY' — An option to define if software updates should be applied within a maintenance window.
    - `lastConnectedAt` string, date-time — The timestamp of the most recent session on the device.
    - `lastPostureAt` string, date-time — The timestamp of the most recent check-in of the device.
    - `createdAt` string, date-time — The timestamp of when the device was created.
    - `updatedAt` string, date-time — The timestamp of when the device was updated.
    - `arn` string — The Amazon Resource Name (ARN) of the device.
    - `lastUserId` string, password — The user ID of the most recent session on the device.
  - `nextToken` string — If <code>nextToken</code> is returned, there are more results available. The value of <code>nextToken</code> is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an <i>HTTP 400 InvalidToken error</i>.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — InternalServerException

---

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