Skip to content

Get app version information
Stable

Request

Retrieves full V1 details for a single application version by its UUID, including direct APK and icon URLs, file size, and release date.

Returns the AppVersionV1 object for the specified version. Use this endpoint over the base version detail when your integration needs app_file, app_icon, size_in_mb, or release_date without the overhead of iterating through a list.

About Get App Version (V1)

The V1 version detail endpoint returns the same core version metadata as GET .../application/{application_id}/version/{version_id}/ but uses the AppVersionV1 schema. Key additions over the base schema include: app_file (a direct URL to the APK binary), app_icon (a direct URL to the version's icon), size_in_mb (file size), and release_date. These additions are particularly useful for integrations that surface version detail in a UI or need to trigger downloads. Note that release_track and target_sdk_version from the base schema are absent in V1 — use the base endpoint if those fields are needed.

Key Fields

app_file — direct URL to download the APK binary for this version

app_icon — direct URL to the version's app icon image

size_in_mb — file size of the APK in megabytes

release_date — timestamp of when this version was released

release_comments — freeform notes about this release

approval_status — current lifecycle status: AVAILABLE, ACCEPTED, APPROVED, or REJECTED (defaults to APPROVED)

is_default — whether this version is the designated default for the application (defaults to false)

installed_count — number of devices with this version currently installed

Common Use Cases

Retrieve a direct APK download URL for a specific version without listing all versions.

Display version detail (icon, size, release date, release comments) in a custom management UI.

Confirm installed_count before deprecating or removing a version.

Best Practices

Use this endpoint instead of the base version detail when app_file, app_icon, or size_in_mb are needed — it avoids a redundant follow-up call.

If release_track or target_sdk_version are required, fall back to the base GET .../application/{application_id}/version/{version_id}/ endpoint.

Verify approval_status=APPROVED and is_default=true or is_enabled (check base schema) before using this version in an install command.

Workflow

Obtain the version_id from a V1 version list call or stored reference

Call this endpoint to retrieve full V1 version detail including file and icon URLs

Use app_file for download or display; confirm approval_status before referencing in an install command

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.

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

Responses

successful operation

Bodyapplication/json
idstring, (uuid)(Id)read-only
installed_countinteger(Installed count)read-only
is_g_playboolean(Is google play)
app_filestring or null, (url)(App file url)
app_iconstring or null, (url)(App icon url)
version_codestring or null, [ 1 .. 50 ] characters(Version code)required
build_numberstring or null, [ 1 .. 100 ] characters(Build number)
min_sdk_versionstring or null, [ 1 .. 10 ] characters(Minimum sdk version)
enterprisestring, (url)(Enterprise URL)required
applicationstring, (url)(Application URL)
release_namestring or null, <= 255 characters(Name of the release)
release_commentsstring or null(Release comments)
approval_statusstring, <= 50 characters(Approval Status)
Default:"APPROVED"
Enum:"AVAILABLE""ACCEPTED""APPROVED""REJECTED"
release_datestring, (date-time)(Release date)
size_in_mbnumber(Size in mb)
is_defaultboolean(Is default)
Default:false
created_onstring, (date-time)(Created on)read-only
Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "installed_count": 0,
  "is_g_play": true,
  "app_file": "string",
  "app_icon": "string",
  "version_code": "string",
  "build_number": "string",
  "min_sdk_version": "string",
  "enterprise": "string",
  "application": "string",
  "release_name": "string",
  "release_comments": "string",
  "approval_status": "AVAILABLE",
  "release_date": "2019-08-24T14:15:22Z",
  "size_in_mb": 0,
  "is_default": false,
  "created_on": "2019-08-24T14:15:22Z"
}