Skip to content

Get tenant app version by ID
Stable

Request

Retrieves the full detail record for a single tenant app version.

Returns the TenantAppVersionDetailResponse for the given appId and versionId, with the same legacy_format option for choosing between build_number and version_code.

About Get Tenant App Version

⚠️ iOS and Windows only. This is the detail view behind a single entry in the app's version list, useful once you already have both the appId and versionId.

Common Use Cases

Confirming a specific version's detail before referencing it in a blueprint or install command

Auditing a specific build's metadata

Best Practices

Set legacy_format to false to receive version_code if your integration doesn't depend on the legacy build_number field

Workflow

Obtain the appId and versionId from the versions list

Call this endpoint for the full version detail

Security
apps_management_apiKey
Path
appIdstring, (uuid)required
versionIdstring, (uuid)required
Query
legacy_formatboolean

If false, returns version_code instead of build_number. Defaults to true for backward compatibility.

Default:true
cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/tenant-apps/{appId}/versions/{versionId}?legacy_format=true' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
contentobject(apps_management_TenantAppVersionDetailResponse)
Response
{
  "content": {
    "id": "string",
    "app_id": "string",
    "app_type": "TENANT_IOS",
    "tenant_id": "string",
    "app_name": "string",
    "app_icon_url": "string",
    "release_notes": "string",
    "description": "string",
    "file_size_in_kb": 0,
    "device_family": [ … ],
    "version_name": "string",
    "build_number": "string",
    "version_code": "string",
    "min_sdk_version": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "created_by": "string",
    "updated_by": "string",
    "is_active": true,
    "success_criteria_type": "REGISTRY_VALIDATION",
    "success_criteria": { … },
    "app_download_url": "string",
    "app_sha256_hash": "string",
    "product_code": "string",
    "install_script": "string",
    "uninstall_script": "string",
    "package_format": "MSIX",
    "package_family_name": "string",
    "identity_name": "string",
    "publisher": "string",
    "architecture": "string",
    "entry_point_type": "string",
    "aumids": [ … ],
    "artifacts": [ … ]
  }
}