# Retrieve details of a specific app with release label information

Get specific app version of the app

## Endpoint

[GET /api/v1/mdm/apps/{app_id}/labels/{release_label_id}](https://www.manageengine.com/products/desktop-central/help/api/onpremise/app-management-get-app-details.html)

## Request

### Request URL

`https://{server-hostname}:8383/api/v1/mdm/apps/{app_id}/labels/{release_label_id}`

### Scope

`MDMDeviceMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** — `string` — **Mandatory**
  - `application/json`

#### Path Parameters

- **app_id** — `string` — **Mandatory**
  - Unique identifier of the application. Obtain from the [Get App List](https://www.manageengine.com/products/desktop-central/help/api/onpremise/app-management-get-an-app.html) response.
- **release_label_id** — `string` — **Mandatory**
  - Unique identifier of the release label. Obtain from the [Get App Details](https://www.manageengine.com/products/desktop-central/help/api/onpremise/app-management-get-app-details.html) response.

#### Query Parameters

- **include** — `string` — Optional
  - Comma-separated list of related fields to include in the response (e.g., assigned_to, payload_details). When omitted, only top-level fields are returned.
- **businessstore_id** — `long` — Optional
  - Unique identifier of the Business Store (Apple VPP / Managed Google Play / Microsoft Store) to scope the request to.

### Sample Request

#### Curl

```curl
curl --request GET \
  --url 'https://appdomain/api/v1/mdm/apps/{app_id}/labels/{release_label_id}?include=SOME_STRING_VALUE&businessstore_id=SOME_INTEGER_VALUE' \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

Response Body — `application/json`

- **JSON Object**
  - **app_id** — `long`
    - Unique identifier for the app.
  - **app_name** — `string`
    - Name of the app.
  - **app_category** — `string`
    - Category of the app.
  - **app_type** — `integer`
    - App type: 0 = Free Store App, 1 = Paid Store App, 2 = Enterprise App.
  - **bundle_identifier** — `string`
    - App bundle identifier.
  - **version** — `string`
    - Version of the app.
  - **platform_type** — `integer`
    - Platform: 1 = iOS, 2 = Android, 3 = Windows.
  - **description** — `string`
    - Custom description of the app.
  - **icon** — `string`
    - URL link for the app icon image. May be null.
  - **store_url** — `string`
    - Store URL for the app (iOS only). May be null.
  - **is_app_paid** — `boolean`
    - Whether the app is a paid app.
  - **country_code** — `string`
    - Country code for App Store (iOS only). May be null.
  - **store_id** — `string`
    - Identifier for the App Store (iOS only). May be null.
  - **added_time** — `long`
    - Epoch timestamp (milliseconds) when the app was added.
  - **modified_time** — `long`
    - Epoch timestamp (milliseconds) when the app was last modified.
  - **release_labels** — `JSON Array`
    - Array of release label objects with version details.

### Possible Response Codes

- **200** — HTTP code

### Sample Response: HTTP 200

Details of an enterprise app with release labels

```json
{
  "store_id": "9007199254741069",
  "app_type": 2,
  "added_time": 1714630800000,
  "icon": "https://appDomain/mdm-logo.png",
  "description": "The is an enterprise app",
  "version": "1.1.1",
  "store_url": "https://www.zylker.com/app/zylker-mdm/id720111835?mt=8",
  "app_name": "Zylker MDM",
  "country_code": "US",
  "modified_time": 1714717200000,
  "platform_type": 2,
  "is_app_paid": false,
  "bundle_identifier": "com.manageengine.mdm.iosagent",
  "app_category": "Education",
  "app_id": 9007199254741080,
  "release_labels": [
    {
      "release_label_type": 1,
      "app_version": "12.3.45",
      "release_label_name": "Stable",
      "release_label_id": 9007199254741076
    }
  ]
}
```

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 60 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.