---
title: "GET /v0.1/sdk/apps/{app_secret}/releases/{release_hash}"
method: GET
path: "/v0.1/sdk/apps/{app_secret}/releases/{release_hash}"
tags: ["distribute"]
---

# GET /v0.1/sdk/apps/{app_secret}/releases/{release_hash}

`GET /v0.1/sdk/apps/{app_secret}/releases/{release_hash}`

If 'latest' is not specified then it will return the specified release if it's enabled. If 'latest' is specified, regardless of whether a release hash is provided, the latest enabled release is returned.

## Path parameters

- `app_secret` string, required
- `release_hash` string, required

## Query parameters

- `udid` string

## Response `200`

If called with a specific `release_hash` return the app's 'display_name'' and 'buildIdentifier'. If 'release_hash' is 'latest' return the full release details of the latest release that was distributed to the current user (from all the distribution groups).

- object — Details of an uploaded release
  - `id` integer, required — ID identifying this unique release.
  - `app_name` string, required — The app's name (extracted from the uploaded release).
  - `app_display_name` string, required — The app's display name.
  - `app_os` string — The app's OS.
  - `version` string, required — The release's version.<br> For iOS: CFBundleVersion from info.plist. For Android: android:versionCode from AppManifest.xml.
  - `origin` 'hockeyapp' | 'appcenter' — The release's origin
  - `short_version` string, required — The release's short version.<br> For iOS: CFBundleShortVersionString from info.plist. For Android: android:versionName from AppManifest.xml.
  - `release_notes` string — The release's release notes.
  - `provisioning_profile_name` string — The release's provisioning profile name.
  - `provisioning_profile_type` 'adhoc' | 'enterprise' | 'other' — The type of the provisioning profile for the requested app version.
  - `provisioning_profile_expiry_date` string — expiration date of provisioning profile in UTC format.
  - `is_provisioning_profile_syncing` boolean — A flag that determines whether the release's provisioning profile is still extracted or not.
  - `size` integer — The release's size in bytes.
  - `min_os` string — The release's minimum required operating system.
  - `device_family` string — The release's device family.
  - `android_min_api_level` string — The release's minimum required Android API level.
  - `bundle_identifier` string — The identifier of the apps bundle.
  - `package_hashes` string[] — Hashes for the packages.
  - `fingerprint` string — MD5 checksum of the release binary.
  - `uploaded_at` string, required — UTC time in ISO 8601 format of the uploaded time.
  - `download_url` string — The URL that hosts the binary for this release.
  - `secondary_download_url` string — The URL that hosts the secondary binary for this release, such as the apk file for aab releases.
  - `app_icon_url` string, required — A URL to the app's icon.
  - `install_url` string — The href required to install a release on a mobile device. On iOS devices will be prefixed with `itms-services://?action=download-manifest&url=`
  - `destination_type` 'group' | 'store' | 'tester' — OBSOLETE. Will be removed in next version. The destination type.<br> <b>group</b>: The release distributed to internal groups and distribution_groups details will be returned.<br> <b>store</b>: The release distributed to external stores and distribution_stores details will be returned.<br> <b>tester</b>: The release distributed testers details will be returned.<br>
  - `distribution_groups` object[] — OBSOLETE. Will be removed in next version. A list of distribution groups that are associated with this release.
    - `id` string, required — ID identifying a unique distribution group.
    - `name` string — A name identifying a unique distribution group.
  - `distribution_stores` object[] — OBSOLETE. Will be removed in next version. A list of distribution stores that are associated with this release.
    - `id` string, required — ID identifying a unique distribution store.
    - `name` string — A name identifying a unique distribution store.
    - `type` 'intune' | 'googleplay' | 'apple' | 'none' — type of the distribution store currently stores type can be intune, googleplay or windows.
    - `publishing_status` string — publishing status of the release in the store.
  - `destinations` object[] — A list of distribution groups or stores.
    - `id` string, required — Id of a distribution group / store. The release will be associated with this distribution group / store. If the distribution group / store doesn't exist a 400 is returned. If both distribution group / store name and id are passed, the id is taking precedence.
    - `name` string — Name of a distribution group / distribution store. The release will be associated with this distribution group or store. If the distribution group / store doesn't exist a 400 is returned. If both distribution group / store name and id are passed, the id is taking precedence.
    - `is_latest` boolean — Is the containing release the latest one in this distribution store.
    - `type` 'intune' | 'googleplay' | 'apple' | 'none' — type of the distribution store currently stores type can be intune, googleplay or windows.
    - `publishing_status` string — publishing status of the release in the store.
    - `destination_type` 'group' | 'store' | 'tester' — Destination can be either store or group.
    - `display_name` string — Display name for the group or tester
  - `is_udid_provisioned` boolean — In calls that allow passing `udid` in the query string, this value will hold the provisioning status of that UDID in this release. Will be ignored for non-iOS platforms.
  - `can_resign` boolean — In calls that allow passing `udid` in the query string, this value determines if a release can be re-signed. When true, after a re-sign, the tester will be able to install the release from his registered devices. Will not be returned for non-iOS platforms.
  - `build` object — Contains metadata about the build that produced the release being uploaded
    - `branch_name` string — The branch name of the build producing the release
    - `commit_hash` string — The commit hash of the build producing the release
    - `commit_message` string — The commit message of the build producing the release
  - `enabled` boolean, required — This value determines the whether a release currently is enabled or disabled.
  - `status` string — Status of the release.
  - `is_external_build` boolean — This value determines if a release is external or not.

## Other responses

- `404` — Error codes: - `not_found` - A release or an app can't be found. - `no_releases_for_user` - No releases available for that user (will only be returned when `release_hash` is `latest`)

---

[API](https://skmtc.net/appcenter/apis/app-center-client.md) · [All operations](https://skmtc.net/appcenter/apis/app-center-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appcenter/app-center-client/revisions/4e9226ab8f35/schema)
