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
- Call GET /enterprise/{enterprise_id}/device/{device_id}/app/ and filter by package_name to locate the app and retrieve its app_id.
- Call this endpoint to retrieve the full DeviceApp record for that specific app.
- Check state, version_code, and is_active to confirm the app's current status on the device.
Path parameters
A UUID string identifying this enterprise.
A UUID string identifying device.
Query parameters
filter by device id
filter by package name
filter by application name
filter by install state
Number of results to return per page.
Return results from this index.
Response
successful operation