Skip to content

List install devices
Stable

Request

List all devices with a specific app version installed. Retrieves a paginated list of devices on which the specified application version is currently installed. Results can be searched by device name, device alias, or group name.

About App Install Tracking

Esper tracks the installation state of each app version across enrolled devices. This endpoint provides an app-centric view of device coverage — rather than querying each device individually for its installed apps, you can query a specific app version to see exactly which devices have it installed. This is particularly useful for verifying deployment coverage after issuing an install command across a fleet.

Platform limitations

This endpoint is not supported for iOS, Linux, or Windows devices — retrieving a list of devices by app version is an Android-only capability. Additionally, kiosk-specific app attributes such as KioskAppName are not included in the summary-level device records returned by this endpoint; retrieving those attributes requires individual device detail calls via GET /enterprise/{enterprise_id}/device/{device_id}/.

Workflow

  1. Call GET /enterprise/{enterprise_id}/application/ to retrieve the application_id for the app you want to audit.
  2. Call GET /enterprise/{enterprise_id}/application/{application_id}/version/ to retrieve the version_id for the specific version.
  3. Call this endpoint to retrieve the list of devices with that version installed.
  4. Cross-reference results against your target device list to identify any devices that are missing the installation.
  5. Use POST /commands/v0/commands/ to issue an install command to devices that have not yet received the app version.
Security
esper_cloud_api_apiKey
Path
version_idstring, (uuid)required

A UUID string identifying this app version.

application_idstring, (uuid)required

A UUID string identifying this application.

enterprise_idstringrequired

A UUID string identifying enterprise.

Query
searchstring

A search term, search based on device name, device alias_name, group name

limitinteger

Number of results to return per page

offsetinteger

Return results from this index.

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/installdevices?search=string&limit=0&offset=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json
countintegerrequired
nextstring or null, (url)
previousstring or null, (url)
resultsArray of objects(esper_cloud_api_InstallDevices)required
Response
{
  "count": 0,
  "next": "string",
  "previous": "string",
  "results": [
    { … }
  ]
}