Get app version information
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 Workflows.
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
A UUID string identifying this app version.
A UUID string identifying this application.
A UUID string identifying enterprise.
Query parameters
If this value exists in cache, delete the application and cache entry.
Response
successful operation