Skip to main content

Sauce Platform API Methods

The Platform APIs provide insight into the current state of the Sauce Labs platform in order to either validate your calls in advance or troubleshoot unexpected results.

Refer to Getting Started for Authentication and Server information.

Get Sauce Labs TestStatus

GET /rest/v1/info/status

Returns the current (30 second cache) availability of the Sauce Labs platform.

Parameters

This method takes no parameters.

Sample Request
curl -u "$SAUCE_USERNAME:$SAUCE_ACCESS_KEY" --location \
--request GET 'https://api.us-west-1.saucelabs.com/rest/v1/info/status' \
--header 'Content-Type: application/json' | json_pp

Responses

200Success.
404Not found.
Sample Response
{
"wait_time": 0.5714026162790697,
"service_operational": true,
"status_message": "Basic service status checks passed."
}

Get Supported Platforms

GET rest/v1/info/platforms/{automation_api}/

Returns the set of supported operating system and browser combinations for the specified automation framework.

Parameters

automation_api

| PATH | REQUIRED | STRING |

The framework for which you are requesting supported platforms. Valid values are:

  • all
  • appium
  • webdriver

Sample Request
curl -u "$SAUCE_USERNAME:$SAUCE_ACCESS_KEY" --location \
--request GET 'https://api.us-west-1.saucelabs.com/rest/v1/info/platforms/all' \
--header 'Content-Type: application/json' | json_pp
--data-raw ''

Responses

200Success.
404Not found.
Sample Response
[
{
"short_version": "11.3",
"long_name": "iPad Simulator",
"api_name": "ipad",
"long_version": "11.3.",
"device": "iPad Simulator",
"latest_stable_version": "",
"automation_backend": "webdriver",
"os": "Mac 10.13"
},
{
"deprecated_backend_versions": [],
"short_version": "11.3",
"long_name": "iPad Simulator",
"recommended_backend_version": "1.9.1",
"long_version": "11.3.",
"api_name": "ipad",
"supported_backend_versions": [
"1.8.1",
"1.9.1"
],
"device": "iPad Simulator",
"latest_stable_version": "",
"automation_backend": "appium",
"os": "Mac 10.13"
},
{
"short_version": "12.0",
"long_name": "iPad Simulator",
"api_name": "ipad",
"long_version": "12.0.",
"device": "iPad Simulator",
"latest_stable_version": "",
"automation_backend": "webdriver",
"os": "Mac 10.13"
},
{
"deprecated_backend_versions": [],
"short_version": "12.0",
"long_name": "iPad Simulator",
"recommended_backend_version": "1.9.1",
"long_version": "12.0.",
"api_name": "ipad",
"supported_backend_versions": [
"1.9.1"
],
"device": "iPad Simulator",
"latest_stable_version": "",
"automation_backend": "appium",
"os": "Mac 10.13"
},
//{...more results}
]

Get End of Life Dates for Appium Versions

GET /rest/v1/info/platforms/appium/eol

Returns the expected date (in Unix time) on which Sauce Labs support for each Appium version is to be discontinued.

Parameters

This method takes no parameters.

Sample Request
curl -u "$SAUCE_USERNAME:$SAUCE_ACCESS_KEY" --location \
--request GET 'https://api.us-west-1.saucelabs.com/rest/v1/info/platforms/appium/eol' \
--header 'Content-Type: application/json' | json_pp

Responses

200Success.
404Not found.
Sample Response
{
"1.20.2": null,
"1.15.0": null,
"1.4.7": 1463270400,
"1.6.2": 1481328000,
"1.6.3": 1554336000,
"1.6.0": 1494288000,
"1.6.1": 1480550400,
"1.6.4": 1554336000,
"1.6.5": 1554336000,
"1.9.1": null,
"1.19.2": null,
"1.19.1": null,
"1.8.0": null,
"1.7.2": 1554336000,
"1.7.1": 1554336000,
"1.4.0": 1460160000,
"1.4.3": 1460160000,
"1.18.3": null,
"1.18.1": null,
"1.5.1": 1468972800,
"1.5.0": 1465776000,
"1.20.1": null,
"1.5.2": 1543622400,
"1.13.0": null,
"1.3.7": 1460160000,
"1.5.3": 1543622400,
"1.20.0": null,
"1.12.1": null,
"1.11.1": null,
"1.8.1": null,
"1.16.0": null,
"1.17.1": null,
"1.3.6": 1460160000,
"1.4.13": 1468972800,
"1.4.10": 1460160000,
"1.4.11": 1463270400,
"1.4.16": 1543622400,
"1.4.14": 1460160000,
"1.4.15": 1460160000
}