v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
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