SAsaucelabs
Device Catalog

List all device descriptors elegible for AccessAPI

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

get/devices

Request

Query parameters

deviceNamestring
Example:iPhone.*

Filter by device identifier (supports regex). Matches the descriptor ID or device name.

osstring
Example:ANDROID

Filter by device OS. Accepted values are ANDROID or IOS.

osVersionstring
Example:17

Filter by device OS version. Will match major version or Regex.

deviceTypestring
Example:PHONE

Filter by device type. Accepted values are TABLET or PHONE.

Response

Ok

idstring required

Unique identifier for this device descriptor.

namestring required

Human-readable device name.

modelNumberstring

Device model number.

manufacturerstring[]

Device manufacturer(s).

os'ANDROID' | 'IOS' required

Operating system type.

osVersionstring required

Operating system version.

apiLevelinteger

Android API level. Only relevant for Android devices.

abiTypestring

CPU architecture/ABI type.

screenSizenumber double

Screen diagonal size in inches.

resolutionWidthinteger

Screen width in pixels.

resolutionHeightinteger

Screen height in pixels.

dpiinteger

Screen pixel density (dots per inch).

dpiNamestring

Android DPI bucket name (ldpi, mdpi, hdpi, xhdpi, xxhdpi, xxxhdpi).

pixelsPerPointinteger

iOS scale factor (pixels per point).

isTabletboolean

Whether the device is a tablet form factor.

isArmboolean

Whether the device has an ARM processor.

isPrivateboolean

Whether this is a private device.

hasOnScreenButtonsboolean

Whether the device has software navigation buttons (Android).

internalOrientation'PORTRAIT' | 'LANDSCAPE'

Internal screen orientation.

defaultOrientation'PORTRAIT' | 'LANDSCAPE'

Default screen orientation.

ramSizeinteger

RAM size in MB.

internalStorageSizeinteger

Internal storage size in MB.

sdCardSizeinteger

SD card size in MB (Android only).

cpuCoresinteger

Number of CPU cores.

cpuFrequencyinteger

CPU frequency in MHz.

cpuType'ARM' | 'X86'

CPU architecture type.

deviceFamily'ANY' | 'IPHONE' | 'IPAD'

iOS device family.

supportsMockLocationsboolean

Whether the device supports mock GPS locations.

supportsAppiumWebAppTestingboolean

Whether the device supports Appium web testing.

supportsGlobalProxyboolean

Whether the device supports global HTTP proxy.

supportsMinicapSocketConnectionboolean

Whether the device supports minicap socket streaming.

supportsManualWebTestingboolean

Whether the device supports manual web testing.

supportsMultiTouchboolean

Whether the device supports multi-touch gestures.

supportsXcuiTestboolean

Whether the device supports XCUITest (iOS only).

isKeyGuardDisabledboolean

Whether the device keyguard/lock screen is disabled.

isRootedboolean

Whether the device is rooted/jailbroken.

isAlternativeIoEnabledboolean

Whether alternative I/O mode is enabled.

Example response

[
  {
    "id": "iPhone_15_Pro_real",
    "name": "iPhone 15 Pro",
    "modelNumber": "A2848",
    "manufacturer": [
      "Apple"
    ],
    "os": "IOS",
    "osVersion": "17.0",
    "apiLevel": 34,
    "abiType": "arm64-v8a",
    "screenSize": 6.1,
    "resolutionWidth": 1179,
    "resolutionHeight": 2556,
    "dpi": 460,
    "dpiName": "xxhdpi",
    "pixelsPerPoint": 3,
    "isArm": true,
    "internalOrientation": "PORTRAIT",
    "defaultOrientation": "PORTRAIT",
    "ramSize": 6144,
    "internalStorageSize": 128000,
    "cpuCores": 6,
    "cpuFrequency": 3230,
    "cpuType": "ARM",
    "deviceFamily": "IPHONE",
    "supportsMockLocations": true,
    "supportsAppiumWebAppTesting": true,
    "supportsGlobalProxy": true,
    "supportsMinicapSocketConnection": true,
    "supportsManualWebTesting": true,
    "supportsMultiTouch": true,
    "supportsXcuiTest": true,
    "isKeyGuardDisabled": true,
    "isAlternativeIoEnabled": true
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.