---
title: "Queries and returns device configurations available to run tests in the cloud"
method: GET
path: "/mobile/device/configuration"
tags: ["MobileDeviceConfiguration"]
---

# Queries and returns device configurations available to run tests in the cloud

`GET /mobile/device/configuration`

## Query parameters

- `workspace_id` string, required

## Response `200`

Mobile device configurations matching the query

- MobileDeviceConfigurationQueryResult — Result envelope for mobile device configuration query results
  - `configurations` MobileDeviceConfiguration[] — All mobile device configurations that matched the query
    - `created_by_id` string — The ID of the user who created this configuration
    - `created_time` integer — The time at which this configuration was created
    - `cloud_training_hot_pool_support` boolean — Device is included in the cloud training hot pool
    - `cloud_runner_hot_pool_support` boolean — Device is included in the cloud runner hot pool
    - `cloud_training_support` boolean — Device supports cloud training
    - `id` string — The unique ID for this configuration entity
    - `last_updated_by_id` string — The ID of the user who last updated this configuration
    - `last_updated_time` integer — The time at which this configuration was last updated
    - `platform` 'android' | 'ios', required — The mobile platform associated with this object
    - `device_manufacturer` string, required — Device manufacturer (Apple, Google, Samsung)
    - `device_name` string, required — Device display name (iPhone 14, Pixel 7 Pro)
    - `device_id` string — Vendor unique device id (pixel_7_pro)
    - `screen_dimensions` DeviceScreenDimensions, required
      - `height` integer, required — Height (pixels)
      - `width` integer, required — Width (pixels)
    - `os_version` string, required — OS version (16.6.1, Oreo, 12.0)
    - `android_configuration` AndroidDeviceConfiguration — Android specific options
      - `api_level` string — Version of API this device is running (34, 33).
      - `abi` string — Application boundary interface identifies combination of CPU and instruction set (x86, x86_64)
  - `default_android_os_version` string — The default Android OS version
  - `default_ios_os_version` string — The default iOS OS version
  - `cursor` string — Cursor used for pagination

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)