The Sauce Labs Cookbook

Sauce Headless

Front End Performance Testing

Insights

External Resources

More Info


Page tree
Skip to end of metadata
Go to start of metadata

Gets information about devices in a specific data center. 

NOTE: For data center details, see Data Center Endpoints.

Get Devices

Get a list of devices in a data center and their characteristics

GET api.us-west-1.saucelabs.com/v1/rdc/devices
curl -u USERNAME:ACCESS_KEY https://api.us-west-1.saucelabs.com/v1/rdc/devices
 Click here to see a sample JSON Response
Example JSON Response
All devices:

https://api.us-west-1.saucelabs.com/v1/rdc/devices

[
    {
        "id": "iPhone_5C_10_1_real",
        "name": "iPhone 5C",
        "modelNumber": "iPhone5,4",
        "manufacturer": [
            "Apple"
        ],
        "isArm": true,
        "hasOnScreenButtons": false,
        "abiType": "armv7s",
        "os": "IOS",
        "osVersion": "10.1.1",
        "apiLevel": 0,
        "screenSize": 4,
        "resolutionWidth": 640,
        "resolutionHeight": 1136,
        "dpi": 326,
        "pixelsPerPoint": 2,
        "isTablet": false,
        "internalOrientation": "PORTRAIT",
        "defaultOrientation": "PORTRAIT",
        "ramSize": 1024,
        "internalStorageSize": 16384,
        "sdCardSize": 0,
        "cpuCores": 2,
        "cpuFrequency": 1300,
        "supportsMockLocations": true,
        "supportsAppiumWebAppTesting": false,
        "isKeyGuardDisabled": false,
        "isRooted": false,
        "isPrivate": false,
        "supportsGlobalProxy": true,
        "supportsMinicapSocketConnection": false,
        "disableMtp": false,
        "deviceFamily": "IPHONE",
        "cpuType": "ARM",
        "isAlternativeIoEnabled": true,
        "supportsMultiTouch": true,
        "dpiName": "xhdpi",
        "supportsManualWebTesting": true,
        "supportsXcuiTest": true,
        "supportsQualityReport": false
    },
    {
        "id": "Huawei_Nexus_6p_8_real_us",
        "name": "Huawei Nexus 6P",
        "modelNumber": "NEXUS6P",
        "manufacturer": [
            "Huawei"
        ],
        "isArm": true,
        "hasOnScreenButtons": true,
        "abiType": "arm64-v8a",
        "os": "ANDROID",
        "osVersion": "8.1.0",
        "apiLevel": 27,
        "screenSize": 5.7,
        "resolutionWidth": 1440,
        "resolutionHeight": 2560,
        "dpi": 518,
        "pixelsPerPoint": 1,
        "isTablet": false,
        "internalOrientation": "PORTRAIT",
        "defaultOrientation": "PORTRAIT",
        "ramSize": 3072,
        "internalStorageSize": 32768,
        "sdCardSize": 0,
        "cpuCores": 4,
        "cpuFrequency": 2000,
        "supportsMockLocations": true,
        "supportsAppiumWebAppTesting": true,
        "isKeyGuardDisabled": false,
        "isRooted": false,
        "isPrivate": false,
        "supportsGlobalProxy": true,
        "supportsMinicapSocketConnection": false,
        "disableMtp": false,
        "deviceFamily": "ANY",
        "cpuType": "ARM",
        "isAlternativeIoEnabled": true,
        "supportsMultiTouch": true,
        "dpiName": "xxhdpi",
        "supportsManualWebTesting": true,
        "supportsXcuiTest": true,
        "supportsQualityReport": true
    },
    {
        "id": "iPhone_5C_9_1_real",
        "name": "iPhone 5C",
        "modelNumber": "iPhone5,4",
        "manufacturer": [
            "Apple"
        ],
        "isArm": true,
        "hasOnScreenButtons": false,
        "abiType": "armv7s",
        "os": "IOS",
        "osVersion": "9.1",
        "apiLevel": 0,
        "screenSize": 4,
        "resolutionWidth": 640,
        "resolutionHeight": 1136,
        "dpi": 326,
        "pixelsPerPoint": 2,
        "isTablet": false,
        "internalOrientation": "PORTRAIT",
        "defaultOrientation": "PORTRAIT",
        "ramSize": 1024,
        "internalStorageSize": 16384,
        "sdCardSize": 0,
        "cpuCores": 2,
        "cpuFrequency": 1300,
        "supportsMockLocations": true,
        "supportsAppiumWebAppTesting": false,
        "isKeyGuardDisabled": false,
        "isRooted": false,
        "isPrivate": false,
        "supportsGlobalProxy": true,
        "supportsMinicapSocketConnection": false,
        "disableMtp": false,
        "deviceFamily": "IPHONE",
        "cpuType": "ARM",
        "isAlternativeIoEnabled": true,
        "supportsMultiTouch": true,
        "dpiName": "xhdpi",
        "supportsManualWebTesting": true,
        "supportsXcuiTest": true,
        "supportsQualityReport": true
    },
    {
        "id": "iPod_Touch_6_10_real_us",
        "name": "iPod Touch 6",
        "modelNumber": "iPod7,1",
        "manufacturer": [
            "Apple"
        ],
        "isArm": true,
        "hasOnScreenButtons": false,
        "abiType": "arm64",
        "os": "IOS",
        "osVersion": "12.1.4",
        "apiLevel": 0,
        "screenSize": 4,
        "resolutionWidth": 640,
        "resolutionHeight": 1136,
        "dpi": 326,
        "pixelsPerPoint": 2,
        "isTablet": false,
        "internalOrientation": "PORTRAIT",
        "defaultOrientation": "PORTRAIT",
        "ramSize": 1024,
        "internalStorageSize": 16384,
        "sdCardSize": 0,
        "cpuCores": 2,
        "cpuFrequency": 1400,
        "supportsMockLocations": true,
        "supportsAppiumWebAppTesting": true,
        "isKeyGuardDisabled": false,
        "isRooted": false,
        "isPrivate": false,
        "supportsGlobalProxy": true,
        "supportsMinicapSocketConnection": true,
        "disableMtp": false,
        "deviceFamily": "IPHONE",
        "cpuType": "ARM",
        "isAlternativeIoEnabled": true,
        "supportsMultiTouch": true,
        "dpiName": "xhdpi",
        "supportsManualWebTesting": true,
        "supportsXcuiTest": true,
        "supportsQualityReport": false
    },
    {
        "id": "LG_G6_real_us",
        "name": "LG G6",
        "modelNumber": "LG-H870DS",
        "manufacturer": [
            "LG"
        ],
        "isArm": true,
        "hasOnScreenButtons": true,
        "abiType": "arm64-v8a",
        "os": "ANDROID",
        "osVersion": "7.0",
        "apiLevel": 24,
        "screenSize": 5.7,
        "resolutionWidth": 1440,
        "resolutionHeight": 2880,
        "dpi": 564,
        "pixelsPerPoint": 1,
        "isTablet": false,
        "internalOrientation": "PORTRAIT",
        "defaultOrientation": "PORTRAIT",
        "ramSize": 4096,
        "internalStorageSize": 32768,
        "sdCardSize": 0,
        "cpuCores": 4,
        "cpuFrequency": 2188,
        "supportsMockLocations": true,
        "supportsAppiumWebAppTesting": true,
        "isKeyGuardDisabled": false,
        "isRooted": false,
        "isPrivate": false,
        "supportsGlobalProxy": true,
        "supportsMinicapSocketConnection": false,
        "disableMtp": false,
        "deviceFamily": "ANY",
        "cpuType": "ARM",
        "isAlternativeIoEnabled": true,
        "supportsMultiTouch": true,
        "dpiName": "xxxhdpi",
        "supportsManualWebTesting": true,
        "supportsXcuiTest": true,
        "supportsQualityReport": true
    },
    ...
]

Get Device

Get information about a specific device

GET api.us-west-1.saucelabs.com/v1/rdc/devices/[DEVICE_ID]
curl -u USERNAME:ACCESS_KEY https://api.us-west-1.saucelabs.com/v1/rdc/devices/[DEVICE_ID]
Parameters

DEVICE_ID

required

string

 The ID of the device you want information about, for example iPhone_5C_10_1_real

 Click here to see a sample JSON Response
Example JSON Response
Single device:

https://api.us-west-1.saucelabs.com/v1/rdc/devices/iPhone_5C_10_1_real

{
    "id": "iPhone_5C_10_1_real",
    "name": "iPhone 5C",
    "modelNumber": "iPhone5,4",
    "manufacturer": [
        "Apple"
    ],
    "isArm": true,
    "hasOnScreenButtons": false,
    "abiType": "armv7s",
    "os": "IOS",
    "osVersion": "10.1.1",
    "apiLevel": 0,
    "screenSize": 4,
    "resolutionWidth": 640,
    "resolutionHeight": 1136,
    "dpi": 326,
    "pixelsPerPoint": 2,
    "isTablet": false,
    "internalOrientation": "PORTRAIT",
    "defaultOrientation": "PORTRAIT",
    "ramSize": 1024,
    "internalStorageSize": 16384,
    "sdCardSize": 0,
    "cpuCores": 2,
    "cpuFrequency": 1300,
    "supportsMockLocations": true,
    "supportsAppiumWebAppTesting": false,
    "isKeyGuardDisabled": false,
    "isRooted": false,
    "isPrivate": false,
    "supportsGlobalProxy": true,
    "supportsMinicapSocketConnection": false,
    "disableMtp": false,
    "deviceFamily": "IPHONE",
    "cpuType": "ARM",
    "isAlternativeIoEnabled": true,
    "supportsMultiTouch": true,
    "dpiName": "xhdpi",
    "supportsManualWebTesting": true,
    "supportsXcuiTest": true,
    "supportsQualityReport": false
}

Get IDs of Available Devices

Get the device IDs of available devices at a data center

GET api.us-west-1.saucelabs.com/v1/rdc/devices/available
curl -u USERNAME:ACCESS_KEY https://api.us-west-1.saucelabs.com/v1/rdc/devices/available
 Click here to see a sample JSON Response
Example JSON Response
IDs of available devices:

https://api.us-west-1.saucelabs.com/v1/rdc/devices/available

[
    "Samsung_Galaxy_Xcover_3_us",
    "iPad_mini_16GB_real",
    "LG_Tribute_5_real_us",
    "Samsung_Galaxy_J5_real",
    "iPhone_5C_10_1_real",
    "Samsung_Galaxy_S_II_Skyrocket_i727_real_us",
    "Huawei_Honor_8_real_us",
    "Motorola_Moto_G_3rd_gen_real",
    "HTC_One_real",
    "OnePlus_3T_real_us",
    "HTC_U11_real",
    "iPad_mini_4_16GB_real",
    "iPhone_6_Plus_9_3_real",
    "iPod_Touch_6_10_real_us",
    "LG_G_Stylo_real_us",
    "iPad_Pro_12_9_93_real_us",
    "Samsung_Galaxy_S4_mini_real_us",
    "iPhone_5C_9_1_real",
    "LG_G6_real_us",
    "Motorola_Moto_G4_real",
    "Samsung_Galaxy_Note_3_5_real",
    ...
]