Skip to content

Get application information
Stable

Request

Lists all versions of a specific application registered in the enterprise library. Returns a paginated collection of AppVersion records for the specified application, filterable by version code, build number. Default page size is 20; results can be ordered by install count.

About List App Versions

An Esper application can have multiple versions, each tracked as a distinct AppVersion record with its own UUID (version_id).The version_id is required when issuing install commands to specific devices.

Key Query Parameters

version_code — filter by the version code string (as set in the APK manifest) build_number — filter by build number approval_status — filter by lifecycle status: AVAILABLE, ACCEPTED, APPROVED, or REJECTED is_enabled — filter for enabled versions only is_default — filter for the default version of the application ordering — sort by installed_count (ascending) or -installed_count (descending) limit — results per page (default: 20)

Common Use Cases

Retrieve the list of versions before selecting one for a device install command

Best Practices

Store version_id values from results — these UUIDs are required for device install and app detail lookups

Workflow

Call this endpoint with the target application_id and any filters Select the appropriate version from the results and record its id (version_id) Use version_id in install commands or in GET .../version/{version_id}/ for full version detail

Security
esper_cloud_api_apiKey
Path
application_idstring, (uuid)required

A UUID string identifying this application.

enterprise_idstringrequired

A UUID string identifying enterprise.

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/enterprise/{enterprise_id}/application/{application_id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json
idstring, (uuid)(Id)read-only
versionsArray of objects(Version)
application_namestring, [ 1 .. 255 ] characters(Application name)required
package_namestring, [ 1 .. 255 ] characters(Package name)required
developerstring or null, [ 1 .. 255 ] characters(Developer)
categorystring or null, [ 1 .. 255 ] characters(Category)
content_ratingstring, (decimal)(Content rating)
compatibilitystring or null, non-empty(Compatibility)
created_onstring, (date-time)(Created on)read-only
updated_onstring, (date-time)(Updated on)read-only
is_activeboolean(Is active)
is_hiddenboolean(Is hidden)
enterprisestring, (url)(Enterprise)required
Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "versions": [
    { … }
  ],
  "application_name": "string",
  "package_name": "string",
  "developer": "string",
  "category": "string",
  "content_rating": "string",
  "compatibility": "string",
  "created_on": "2019-08-24T14:15:22Z",
  "updated_on": "2019-08-24T14:15:22Z",
  "is_active": true,
  "is_hidden": true,
  "enterprise": "string"
}