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

# POST /devices

`POST /devices`

Searches for devices using the specified filters.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `filters` SearchDevicesFilter[], required — The filter values to use to search for a device.
    - `name` string, required — The name to use to filter results.
    - `values` String256[], required — The values to use to filter results.
  - `maxResults` integer — The maximum number of results to return in the response.
  - `nextToken` string — A token used for pagination of results returned in the response. Use the token returned from the previous request continue results where the previous request ended.

## Response `200`

Success

- SearchDevicesResponse
  - `devices` DeviceSummary[], required — An array of <code>DeviceSummary</code> objects for devices that match the specified filter values.
    - `deviceArn` string, required — The ARN of the device.
    - `deviceName` string, required — The name of the device.
    - `deviceStatus` 'ONLINE' | 'OFFLINE' | 'RETIRED', required — The status of the device.
    - `deviceType` 'QPU' | 'SIMULATOR', required — The type of the device.
    - `providerName` string, required — The provider of the device.
  - `nextToken` string — A token used for pagination of results, or null if there are no additional results. Use the token value in a subsequent request to continue results where the previous request ended.

## Other responses

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

---

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