Get Available Desktop Web Devices

Get the list of available Desktop Web Devices in the Perfecto Lab.

Restriction: This API endpoint is not supported in the Free Trial cloud.

URL

Copy
https://<your-cloud>.perfectomobile.com/web/api/v1/config/devices

Method

GET

Header parameters

Name

Description

Perfecto-Authorization

Security Token

Tip: Instead of installing Postman, you can use the built-in cURL command (Windows/Linux). The following example overwrites the user agent with an empty string because using the cURL user agent results in a 403 error.
Copy
curl -H "Perfecto-Authorization: <SECURITY_TOKEN>" -H "User-Agent:" https://<CLOUD_NAME>.perfectomobile.com/web/api/v1/config/devices
Tip: If you use the browser and try the following URL in your web browser, it will throw a 401 authorization error, regardless of whether you pass the security token or not.

https://<your-cloud>.perfectomobile.com/web/api/v1/config/devices?Perfecto-Authorization=YourTokenHere

Instead, use an API tool (such as POSTMAN) to pass the Perfecto-Authorization as a header, not as a parameter.

Request response

The response is a JSON formatted list of available device configurations, detailing the available operating systems, browsers, screen resolutions and locations.

Copy

JSON response

{
    "desktopDevices": [
        {
            "os": "Mac",
            "resolutions": [
                "800x600",
                "1024x768",
                "1280x1024",
                "1280x720",
                "1440x900",
                "1680x1050",
                "1920x1080",
                "2560x1440",
                "3840x2160"            ],
            "osVersions": [
                {
                    "osVersion": "macOS High Sierra",
                    "locations": [
                        "NA-US-BOS"                    ],
                    "browsers": [
                        {
                            "browser": "Chrome",
                            "browserVersions": [
                                "beta",
                                "67",
                                "66",
                                "65",
                                "64",
                                "63",
                                "62",
                                "61",
                                "60"                            ]
                        },
                        {
                            "browser": "Firefox",
                            "browserVersions": [
                                "beta",
                                "61",
                                "60",
                                "59",
                                "58",
                                "57"                            ]
                        },
                        {
                            "browser": "Safari",
                            "browserVersions": [
                                "11"                            ]
                        }
                    ]
                },
                {
                    "osVersion": "macOS Sierra",
                    "locations": [
                        "NA-US-BOS"                    ],
                    "browsers": [
                        {
                            "browser": "Chrome",
                            "browserVersions": [
                                "beta",
                                "68",
                                "67",
                                "66",
                                "65",
                                "64",
                                "63",
                                "62",
                                "61",
                                "60"                            ]
                        },
                        {
                            "browser": "Firefox",
                            "browserVersions": [
                                "beta",
                                "61",
                                "60",
                                "59",
                                "58",
                                "57"                            ]
                        },
                        {
                            "browser": "Safari",
                            "browserVersions": [
                                "10"                            ]
                        }
                    ]
                }
            ]
        },
        {
            "os": "Windows",
            "resolutions": [
                "1024x768",
                "1280x1024",
                "1366x768",
                "1440x900",
                "1600x1200",
                "1920x1080"            ],
            "osVersions": [
                {
                    "osVersion": "10",
                    "locations": [
                        "US East"                    ],
                    "browsers": [
                        {
                            "browser": "Chrome",
                            "browserVersions": [
                                "beta",
                                "69",
                                "68",
                                "67",
                                "66",
                                "65",
                                "64",
                                "63",
                                "62",
                                "61"                            ]
                        },
                        {
                            "browser": "Edge",
                            "browserVersions": [
                                "17",
                                "16",
                                "15",
                                "14"                            ]
                        },
                        {
                            "browser": "Firefox",
                            "browserVersions": [
                                "beta",
                                "61",
                                "60",
                                "59",
                                "58",
                                "57"                            ]
                        },
                        {
                            "browser": "Internet Explorer",
                            "browserVersions": [
                                "11"                            ]
                        }
                    ]
                },
                {
                    "osVersion": "8.1",
                    "locations": [
                        "US East"                    ],
                    "browsers": [
                        {
                            "browser": "Chrome",
                            "browserVersions": [
                                "beta",
                                "69",
                                "68",
                                "67",
                                "66",
                                "65",
                                "64",
                                "63",
                                "62",
                                "61"                            ]
                        },
                        {
                            "browser": "Firefox",
                            "browserVersions": [
                                "beta",
                                "61",
                                "60",
                                "59",
                                "58",
                                "57",
                                "56",
                                "55",
                                "54"                            ]
                        },
                        {
                            "browser": "Internet Explorer",
                            "browserVersions": [
                                "11"                            ]
                        }
                    ]
                },
                {
                    "osVersion": "7",
                    "locations": [
                        "US East"                    ],
                    "browsers": [
                        {
                            "browser": "Chrome",
                            "browserVersions": [
                                "beta",
                                "69",
                                "68",
                                "67",
                                "66",
                                "65",
                                "64",
                                "63",
                                "62",
                                "61"                            ]
                        },
                        {
                            "browser": "Firefox",
                            "browserVersions": [
                                "beta",
                                "61",
                                "60",
                                "59",
                                "58",
                                "57",
                                "56",
                                "55",
                                "54"                            ]
                        },
                        {
                            "browser": "Internet Explorer",
                            "browserVersions": [
                                "11"                            ]
                        }
                    ]
                }
            ]
        }
    ],
    "info": {
        "modelVersion": "1.0",
        "systemTime": "1538469850927",
        "date": "Tue Oct 02 08:44:10 UTC 2018"    }
}