# ListDevices
Gets information about unique device types.
## Request Syntax
```
{
"arn": "string",
"filters": [
{
"attribute": "string",
"operator": "string",
"values": [ "string" ]
}
],
"nextToken": "string"
}
```
## Request Parameters
For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).
The request accepts the following data in JSON format.
** [arn](#API_ListDevices_RequestSyntax) **
The Amazon Resource Name (ARN) of the project.
Type: String
Length Constraints: Minimum length of 32. Maximum length of 1011.
Pattern: `^arn:aws:devicefarm:.+`
Required: No
** [filters](#API_ListDevices_RequestSyntax) **
Used to select a set of devices. A filter is made up of an attribute, an operator, and one or more values.
+ Attribute: The aspect of a device such as platform or model used as the selection criteria in a device filter.
Allowed values include:
+ ARN: The Amazon Resource Name (ARN) of the device (for example, `arn:aws:devicefarm:us-west-2::device:12345Example`).
+ PLATFORM: The device platform. Valid values are ANDROID or IOS.
+ OS\$1VERSION: The operating system version (for example, 10.3.2).
+ MODEL: The device model (for example, iPad 5th Gen).
+ AVAILABILITY: The current availability of the device. Valid values are AVAILABLE, HIGHLY\$1AVAILABLE, BUSY, or TEMPORARY\$1NOT\$1AVAILABLE.
+ FORM\$1FACTOR: The device form factor. Valid values are PHONE or TABLET.
+ MANUFACTURER: The device manufacturer (for example, Apple).
+ REMOTE\$1ACCESS\$1ENABLED: Whether the device is enabled for remote access. Valid values are TRUE or FALSE.
+ REMOTE\$1DEBUG\$1ENABLED: Whether the device is enabled for remote debugging. Valid values are TRUE or FALSE. Because remote debugging is [no longer supported](https://docs.aws.amazon.com/devicefarm/latest/developerguide/history.html), this attribute is ignored.
+ INSTANCE\$1ARN: The Amazon Resource Name (ARN) of the device instance.
+ INSTANCE\$1LABELS: The label of the device instance.
+ FLEET\$1TYPE: The fleet type. Valid values are PUBLIC or PRIVATE.
+ Operator: The filter operator.
+ The EQUALS operator is available for every attribute except INSTANCE\$1LABELS.
+ The CONTAINS operator is available for the INSTANCE\$1LABELS and MODEL attributes.
+ The IN and NOT\$1IN operators are available for the ARN, OS\$1VERSION, MODEL, MANUFACTURER, and INSTANCE\$1ARN attributes.
+ The LESS\$1THAN, GREATER\$1THAN, LESS\$1THAN\$1OR\$1EQUALS, and GREATER\$1THAN\$1OR\$1EQUALS operators are also available for the OS\$1VERSION attribute.
+ Values: An array of one or more filter values.
+ The IN and NOT\$1IN operators take a values array that has one or more elements.
+ The other operators require an array with a single element.
+ In a request, the AVAILABILITY attribute takes the following values: AVAILABLE, HIGHLY\$1AVAILABLE, BUSY, or TEMPORARY\$1NOT\$1AVAILABLE.
Type: Array of [DeviceFilter](API_DeviceFilter.md) objects
Required: No
** [nextToken](#API_ListDevices_RequestSyntax) **
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Type: String
Length Constraints: Minimum length of 4. Maximum length of 1024.
Required: No
## Response Syntax
```
{
"devices": [
{
"arn": "string",
"availability": "string",
"carrier": "string",
"cpu": {
"architecture": "string",
"clock": number,
"frequency": "string"
},
"fleetName": "string",
"fleetType": "string",
"formFactor": "string",
"heapSize": number,
"image": "string",
"instances": [
{
"arn": "string",
"deviceArn": "string",
"instanceProfile": {
"arn": "string",
"description": "string",
"excludeAppPackagesFromCleanup": [ "string" ],
"name": "string",
"packageCleanup": boolean,
"rebootAfterUse": boolean
},
"labels": [ "string" ],
"status": "string",
"udid": "string"
}
],
"manufacturer": "string",
"memory": number,
"model": "string",
"modelId": "string",
"name": "string",
"os": "string",
"platform": "string",
"radio": "string",
"remoteAccessEnabled": boolean,
"remoteDebugEnabled": boolean,
"resolution": {
"height": number,
"width": number
}
}
],
"nextToken": "string"
}
```
## Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
** [devices](#API_ListDevices_ResponseSyntax) **
Information about the devices.
Type: Array of [Device](API_Device.md) objects
** [nextToken](#API_ListDevices_ResponseSyntax) **
If the number of items that are returned is significantly large, this is an identifier that is also returned. It can be used in a subsequent call to this operation to return the next set of items in the list.
Type: String
Length Constraints: Minimum length of 4. Maximum length of 1024.
## Errors
For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).
** ArgumentException **
An invalid argument was specified.
** message **
Any additional information about the exception.
HTTP Status Code: 400
** LimitExceededException **
A limit was exceeded.
** message **
Any additional information about the exception.
HTTP Status Code: 400
** NotFoundException **
The specified entity was not found.
** message **
Any additional information about the exception.
HTTP Status Code: 400
** ServiceAccountException **
There was a problem with the service account.
** message **
Any additional information about the exception.
HTTP Status Code: 400
## See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
+ [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devicefarm-2015-06-23/ListDevices)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devicefarm-2015-06-23/ListDevices)