DRdroidrun
Devices

List devices

Changed on

Returns a paginated list of the user's devices along with pagination metadata. By default every device except terminated and unknown-state ones is listed, including stopped and maintenance devices; narrow with e.g. state=ready or state=stopped,maintenance, and pass state=terminated or state=unknown to see those.

get/devices

Request

  • Base URL
    https://api.mobilerun.ai
  • URL
    https://api.mobilerun.ai/devices
  • Auth
    HTTP bearer

Query parameters

statestring[] nullable

Filter by current device state. Comma-separated (state=ready,stopped). Defaults to every state except terminated and unknown, so stopped and maintenance devices are listed; pass state=terminated or state=unknown to see those.

type'android_cloud_phone' | 'android_physical_phone' | 'ios_stealth_phone' | 'ios_phone' | 'android_emulator' | 'ios_simulator' | 'device_slot'

Canonical device type. Retired dedicated_* aliases are no longer accepted. Availability depends on the deployment.

platform'android' | 'ios'

Filter by the device's platform as served in the platform field (runtime, announced, else type-derived).

countrystring
namestring
searchstring

Case-insensitive search: matches devices whose name contains the term or whose ID starts with it. Combined with all other filters.

providerIdstring
mineboolean

When true, only return devices created by the authenticated caller.

createdBystring

Filter to devices created by this user id. Mutually exclusive with mine.

createdAfterstring date-time

Include devices created at or after this RFC3339 timestamp.

createdBeforestring date-time

Include devices created before this RFC3339 timestamp (exclusive). Must be later than createdAfter when both are set.

pageinteger
pageSizeinteger
orderBy'id' | 'createdAt' | 'updatedAt' | 'assignedAt' | 'gridPosition'
orderByDirection'asc' | 'desc'

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/ResponseDeviceInfo.json",
  "items": [
    {
      "$schema": "https://example.com/schemas/DeviceInfo.json"
    }
  ]
}

Changes