esper_cloud_api_AndroidDevice

List installed apps

Get details of a specific app installed on an Android device. Retrieves the full DeviceApp record for a single app identified by app_id on the specified Android device, including the app's app_name, package_name, state, app_type, version_code, version_name, is_active, is_kiosk_app, is_esper_controlled, whitelisted, is_data_clearable, and is_uninstallable fields.

This endpoint is for Android devices only. For other platforms use the following alternatives:

iOS and other non-Android devices: GET /v2/devices/{deviceId}/device-apps/ — returns apps for a device and supports filtering by app type including VPP, TENANT_IOS, ESPER_IOS, WEBCLIP, ESPER_WINDOWS, and TENANT_WINDOWS

Common Use Cases

Retrieving the full details of a specific app on an Android device to check its current state, version, or kiosk configuration, confirming whether an app is set as the kiosk app (is_kiosk_app: true) on a device, verifying app attributes such as is_uninstallable or is_data_clearable before issuing an uninstall or data-clear command, and auditing whether a specific app is whitelisted on a device.

Workflow

  1. Call GET /enterprise/{enterprise_id}/device/{device_id}/app/ and filter by package_name to locate the app and retrieve its app_id.
  2. Call this endpoint to retrieve the full DeviceApp record for that specific app.
  3. Check state, version_code, and is_active to confirm the app's current status on the device.
get/enterprise/{enterprise_id}/device/{device_id}/install/

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

device_idstring required

A UUID string identifying device.

Query parameters

devicestring

filter by device id

package_namestring

filter by package name

application_namestring

filter by application name

install_statestring

filter by install state

limitinteger

Number of results to return per page.

offsetinteger

Return results from this index.

Response

successful operation

countinteger required
nextstring url nullable
previousstring url nullable

Changes