Get Available Desktop Web Devices

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

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

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
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"    }
}