---
title: "List all device descriptors elegible for AccessAPI"
method: GET
path: "/devices"
tags: ["Device Catalog"]
---

# List all device descriptors elegible for AccessAPI

`GET /devices`

## Request

- Base URL: `https://api.us-west-1.saucelabs.com/rdc/v2`
- URL: `https://api.us-west-1.saucelabs.com/rdc/v2/devices`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/docs/devices/get.ts> (a function with typed inputs; its response is checked against the schema)

List our catalog of devices available for AccessAPI usage. Use this endpoint to retrieve 'device descriptors'.

## Query parameters

- `deviceName` string
- `os` string
- `osVersion` string
- `deviceType` string

## Response `200`

Ok

- DeviceDescriptor[]
  - `id` string, required: Unique identifier for this device descriptor.
  - `name` string, required: Human-readable device name.
  - `modelNumber` string: Device model number.
  - `manufacturer` string[]: Device manufacturer(s).
  - `os` 'ANDROID' | 'IOS', required: Operating system type.
  - `osVersion` string, required: Operating system version.
  - `apiLevel` integer: Android API level. Only relevant for Android devices.
  - `abiType` string: CPU architecture/ABI type.
  - `screenSize` number, double: Screen diagonal size in inches.
  - `resolutionWidth` integer: Screen width in pixels.
  - `resolutionHeight` integer: Screen height in pixels.
  - `dpi` integer: Screen pixel density (dots per inch).
  - `dpiName` string: Android DPI bucket name (ldpi, mdpi, hdpi, xhdpi, xxhdpi, xxxhdpi).
  - `pixelsPerPoint` integer: iOS scale factor (pixels per point).
  - `isTablet` boolean: Whether the device is a tablet form factor.
  - `isArm` boolean: Whether the device has an ARM processor.
  - `isPrivate` boolean: Whether this is a private device.
  - `hasOnScreenButtons` boolean: Whether the device has software navigation buttons (Android).
  - `internalOrientation` 'PORTRAIT' | 'LANDSCAPE': Internal screen orientation.
  - `defaultOrientation` 'PORTRAIT' | 'LANDSCAPE': Default screen orientation.
  - `ramSize` integer: RAM size in MB.
  - `internalStorageSize` integer: Internal storage size in MB.
  - `sdCardSize` integer: SD card size in MB (Android only).
  - `cpuCores` integer: Number of CPU cores.
  - `cpuFrequency` integer: CPU frequency in MHz.
  - `cpuType` 'ARM' | 'X86': CPU architecture type.
  - `deviceFamily` 'ANY' | 'IPHONE' | 'IPAD': iOS device family.
  - `supportsMockLocations` boolean: Whether the device supports mock GPS locations.
  - `supportsAppiumWebAppTesting` boolean: Whether the device supports Appium web testing.
  - `supportsGlobalProxy` boolean: Whether the device supports global HTTP proxy.
  - `supportsMinicapSocketConnection` boolean: Whether the device supports minicap socket streaming.
  - `supportsManualWebTesting` boolean: Whether the device supports manual web testing.
  - `supportsMultiTouch` boolean: Whether the device supports multi-touch gestures.
  - `supportsXcuiTest` boolean: Whether the device supports XCUITest (iOS only).
  - `isKeyGuardDisabled` boolean: Whether the device keyguard/lock screen is disabled.
  - `isRooted` boolean: Whether the device is rooted/jailbroken.
  - `isAlternativeIoEnabled` boolean: Whether alternative I/O mode is enabled.

## Other responses

- `400`: Bad Request
- `401`: Not Authorized

---

[API](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference.md) - [All operations](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/revisions/f845a4b66e37?raw)