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