Skip to content

List product installations
Stable

Request

List all installation records for Google Play applications on a Google Enterprise (EMM) instance. Retrieves a paginated list of installation records for the specified product, each representing the install state of the app on a specific GMS device. Results can be filtered by Google device ID, install state, version code, creation timestamp range, and active status.

Best Practices

Call GET /v0/enterprise/{enterprise_id}/emm/{emm_id}/product/ to retrieve the Esper-generated id UUID for the app you want to audit — this is the value used as product_id in the path.

Security
esper_cloud_api_apiKey
Path
enterprise_idstringrequired

A UUID string identifying this enterprise.

emm_idintegerrequired

An integer representing the ID of enterprise.

product_idstringrequired

A string identifying the product.

Query
google_productstring

Filter by Google product

google_devicestring

Filter by Google device

install_statestring

Filter by install state

version_codestring

Filter by version code

created_on_gtstring, (datetime)

filter installations created after a given timestamp

created_on_ltstring, (datetime)

filter installations created before a given timestamp

is_activeboolean

filter by active installations

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v0/enterprise/{enterprise_id}/emm/{emm_id}/product/{product_id}/install/?google_product=string&google_device=string&install_state=string&version_code=string&created_on_gt=string&created_on_lt=string&is_active=true' \
  -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_GoogleProductInstall)required
Response
{
  "count": 0,
  "next": "string",
  "previous": "string",
  "results": [
    { … }
  ]
}