Get Plan Environment List

Endpoint Information

  • URL: <your-gateway-url>/environment/plan/{planId}

  • Method: GET

  • Authentication: Required (Bearer Token)

Response Body

{
    "data": [
        {
            "id": 753,
            "platform": "iOS",
            "platformName": null,
            "platformVersion": "18.6.2",
            "model": "iPhone13,2",
            "modelName": null,
            "manufacturer": "Apple",
            "marketName": "iPhone 12",
            "testFrameworkType": "APPIUM2",
            "udid": null,
            "licenceId": null,
            "enabled": null,
            "privateDevice": false
        }
    ],
    "result": {
        "code": 0,
        "message": "success"
    }
}
Parameter
Type
Description

id

Long

Unique identifier of the device in the system.

platform

String

Operating system of the device

platformName

String

Human-readable name of the operating system (e.g., “iOS”, “Android OS”).

platformVersion

String

Version of the operating system running on the device.

model

String

Device model identifier assigned by the manufacturer (e.g., “iPhone13,2”, “SM-A305F”).

modelName

manufacturer

String

Name of the device manufacturer (e.g., “Apple”, “Samsung”).

marketName

String

Commercial or user-friendly name of the device (e.g., “iPhone 12”, “Galaxy A30”).

testFrameworkType

String

The supported test automation framework for this device (e.g., “APPIUM”, “SELENIUM”).

udid

String

Unique device identifier used by the debugging/test framework. (Sensitive — mask in public docs.)

licenceId

String

Identifier for the license associated with the device (if licensing is required).

enabled

boolean

Indicates whether the device is enabled and available for scheduling.

privateDevice

boolean

Indicates whether the device is private to a specific company/user or part of the shared device pool.

Parameter
Type
Description

data

Object

The payload of the response. In this case null since no extra data is returned.

result

Object

Contains details about the outcome of the operation.

result.code

Integer

The result code (e.g., 0 indicates success).

result.message

String

A message describing the outcome (e.g., "success").

Error Codes

HTTP Code
Error Message
Description

401

UNAUTHORIZED

The request lacks valid authentication credentials. Check your Bearer token.

400

INVALID_REQUEST

The request was malformed or contained errors.

500

INTERNAL_SERVER_ERROR

An unexpected error occurred on the server side.

Example Request

curl --location '<your-gateway-url>/environment/plan/{planId}' \
--header 'accept: application/json, text/plain, */*' \
--header 'authorization: Bearer <your_access_token>' \
--header 'content-type: application/json'

Last updated