---
title: "Get app version information"
method: GET
path: "/enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/"
tags: ["esper_cloud_api_Application"]
---

# Get app version information

`GET /enterprise/{enterprise_id}/application/{application_id}/version/{version_id}/`

Retrieves full details for a single application version by its UUID.
Returns the AppVersion object including version code, build number, release name, release track, approval status, enabled/default state, SDK version constraints, and install count. Use when you need complete metadata on a specific version identified by version_id.

About Get App Version

AppVersion records in Esper represent individual APK builds associated with an application. Each version has its own version_id UUID and carries release lifecycle metadata — including its release_track (Alpha, Beta, or Production), approval_status, and is_enabled flag — that governs whether it is eligible for deployment. This endpoint also includes a request_id query parameter that, when matched in cache, triggers deletion of the cached application and entry, useful for invalidating stale state during upload **Workflow**s.

Key Fields / Query Parameters

application_id - The UUID of the application

version_id — path parameter UUID identifying this specific version

version_code — the version identifier from the APK manifest

build_number — build-level identifier for the release

is_enabled — whether this version is available for deployment

is_default — whether this version is the designated default for the application

**Common Use Cases**

Confirm the approval status and release track of a version before scheduling a device install
Retrieve SDK version constraints (min_sdk_version, target_sdk_version) to verify device compatibility
Look up a version's installed_count to understand deployment breadth before deprecating or replacing it

**Best Practices**

Verify is_enabled=true before using a version_id in an install command
Use this endpoint rather than the version list when you already have the version_id and need authoritative metadata fast

**Workflow**

Obtain the version_id from a prior version list call or stored reference
Call this endpoint to retrieve full version metadata
Confirm release track and approval status, then proceed with install or deployment commands

## Path parameters

- `version_id` string, uuid, required
- `application_id` string, uuid, required
- `enterprise_id` string, required

## Query parameters

- `request_id` string

## Response `200`

successful operation

- EsperCloudApiAppVersion
  - `id` string, uuid
  - `installed_count` integer
  - `permissions` EsperCloudApiAppPermission[], required
    - `id` string, uuid
    - `permission` string, required
    - `grant_state` 'Default' | 'Denied' | 'Granted'
    - `created_on` string, date-time
    - `updated_on` string, date-time
    - `is_active` boolean
    - `enterprise` string, url, required
    - `app_version` string, url
  - `app_file` string, url
  - `app_icon` string, url, nullable
  - `version_code` string, required
  - `build_number` string, nullable
  - `size_in_mb` number
  - `hash_string` string
  - `release_name` string, nullable
  - `release_comments` string, nullable
  - `release_track` 'Alpha' | 'Beta' | 'Production', nullable
  - `created_on` string, date-time
  - `updated_on` string, date-time
  - `min_sdk_version` string, nullable
  - `target_sdk_version` string, nullable
  - `is_enabled` boolean
  - `is_default` boolean
  - `enterprise` string, url, required
  - `application` string, url
  - `approval_status` 'AVAILABLE' | 'ACCEPTED' | 'APPROVED' | 'REJECTED'

## Other responses

- `401` — Authorization information is missing or invalid.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.dev/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.dev/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/e1f64cbb488e/schema)