v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_AndroidDevice

List all device apps

⚠️ Android only. This endpoint applies exclusively to Android-managed devices enrolled in Esper. Alternative Available

For iOS and Windows device applications, use /api/v2/tenant-esper-apps

Lists all apps present on a specific enrolled device, as tracked by Esper. Returns a paginated DeviceApp collection reflecting the apps Esper is aware of on the device, filterable by package name or app name. Default page size is 20.

About List Device Apps

The DeviceApp resource represents the per-device app inventory as seen by Esper — each record corresponds to an app instance on the device, tied to the device's reported state. This differs from the enterprise application library (.../application/) which tracks apps available for deployment; the device app list reflects what is actually installed and known on a given device. Results can be filtered by package name for precise lookups or searched by app name for broader discovery.

Key Query Parameters

package_name — filter by exact Android package name (e.g. com.example.app)

whitelisted — filter by whitelist status

search — free-text search by app name (app_name field)

limit — results per page (default: 20)

Common Use Cases

Audit which apps are installed on a specific device for compliance or security review. Verify that a target app (by package name) is present on the device before or after an install command. Check whitelist status of installed apps on a managed device.

Best Practices

Use package_name for targeted lookups rather than fetching the full list and filtering client-side. Cross-reference results with the enterprise application library to identify apps on the device that are not managed through Esper. Confirm app presence via this endpoint after issuing an install command to verify successful delivery.

Workflow

Obtain the device_id from a device list or stored reference. Call this endpoint, optionally filtering by package_name or search. Review the returned DeviceApp records to confirm installation state and whitelist status.

get/enterprise/{enterprise_id}/device/{device_id}/app/

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

device_idstring required

A UUID string identifying device.

Query parameters

package_namestring

Filter by Package name

whitelistedstring

Whitelist filter

searchstring

A search term. Search by app_name.

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