Retrieve details of a specific app with release label information

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Get specific app version of the app

Request URL

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

Scope

MDMDeviceMgmt.READCopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/jsonapplication/jsonCopied!

- Path Parameters

app_idstringMandatory

Unique identifier of the application. Obtain from the Get App List response

release_label_idstringMandatory

Unique identifier of the release label. Obtain from the Get App Details response

- Query Parameters

includestringOptional

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_idlongOptional

Unique identifier of the Business Store (Apple VPP / Managed Google Play / Microsoft Store) to scope the request to

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
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 Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
app_idlong

Unique identifier for the app

app_namestring

Name of the app

app_categorystring

Category of the app

app_typeinteger

App type: 0 = Free Store App, 1 = Paid Store App, 2 = Enterprise App

bundle_identifierstring

App bundle identifier

versionstring

Version of the app

platform_typeinteger

Platform: 1 = iOS, 2 = Android, 3 = Windows

descriptionstring

Custom description of the app

iconstring

URL link for the app icon image. May be null

store_urlstring

Store URL for the app (iOS only). May be null

is_app_paidboolean

Whether the app is a paid app

country_codestring

Country code for App Store (iOS only). May be null

store_idstring

Identifier for the App Store (iOS only). May be null

added_timelong

Epoch timestamp (milliseconds) when the app was added

modified_timelong

Epoch timestamp (milliseconds) when the app was last modified

release_labelsJSON Array

Array of release label objects with version details

Show Sub-Attributes
JSON Object
Show Sub-Attributes
release_label_typeinteger

Version type: 1 = Stable, 2 = Beta

release_label_namestring

Label name (e.g., Stable, Beta)

release_label_idlong

Unique ID for the release label

app_versionstring

The version of the app in this label

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

Details of an enterprise app with release labels

Copied!
  {
    "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
      }
    ]
  }
                
Show full

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.