---
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}`

## Request

- Base URL: `https://api.appcenter.ms`
- URL: `https://api.appcenter.ms/v0.1/sdk/apps/{app_secret}/releases/{release_hash}`
- Auth: API key in header `X-API-Token`
- TypeScript: <https://skmtc.dev/appcenter/apis/app-center-client/docs/v0.1/sdk/apps/:app_secret/releases/:release_hash/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/appcenter/apis/app-center-client.md) - [All operations](https://skmtc.dev/appcenter/apis/app-center-client/llms.txt) - [OpenAPI document](https://skmtc.dev/appcenter/apis/app-center-client/revisions/4e9226ab8f35?raw)