Skip to content

Device Apps

APIs to get apps installed on iOS devices. Use Application to get apps for Android devices.

Operations

Get all apps for a device in the tenant
Stable

Request

Retrieves a paginated list of every app installed on a specific device.

Returns each app's DeviceAppsResponse record, filterable by app type such as VPP, tenant-uploaded iOS or Windows apps, Esper iOS apps, or webclips.

About Get Device Apps

This is the v2 device-scoped app inventory, showing exactly what's installed on one device across its supported app types. It complements the tenant-wide app catalogs (Tenant Apps, Tenant Esper Apps, VPP) by showing installation state on a specific device rather than what's available to install.

Key Fields / Query Parameters

app type — filters by one or more app types, comma-separated, for example VPP, TENANT_IOS, or WEBCLIP

Common Use Cases

Auditing exactly which apps are installed on a specific device

Confirming an app installed through a command or Converge action actually landed on the target device

Filtering by app type to check only VPP-licensed apps or only webclips on a device

Best Practices

Filter by app type when you only care about one category, rather than paging through every installed app

Cross-reference results against the Tenant Apps or Tenant Esper Apps catalog to confirm a device has the expected version installed

Workflow

Obtain the deviceId

Call this endpoint, optionally filtering by app type

Compare the results against the expected app list from a blueprint or command

Security
device_apiKey
Path
deviceIdstringrequired

ID of the device

Query
app typestring

App Type to filter list by, supports multiple values separated by comma

Enum:"VPP""TENANT_IOS""ESPER_IOS""WEBCLIP""ESPER_WINDOWS""TENANT_WINDOWS""TENANT_WINDOWS_EXE""TENANT_WINDOWS_UWP"
limitinteger
offsetinteger
cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/devices/{deviceId}/device-apps/?app%20type=VPP&limit=0&offset=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
resultsArray of objects(device_DeviceAppsResponse)
Response
{
  "results": [
    { … }
  ]
}