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.
Path parameters
A UUID string identifying this enterprise.
A UUID string identifying device.
Query parameters
Filter by Package name
Whitelist filter
A search term. Search by app_name.
Number of results to return per page.
Return results from this index.
Response
successful operation