Table of Contents

API : FlexCare : App whitelist : Get release

Introduction

This will get a single release (APK version) of a whitelisted app.

A release describes one version of the app that can be installed on tablets. File names are looked up for the APK file and each bundled file, when the files exist.

Request

URL https://api.telecomx.dk/flexcare/appwhitelist/APP_ID/release/RELEASE_ID
Method GET
Access level ADMIN, or RESELLER admin with the TV employee feature
Param APP_ID Unique id (ObjectId) of the app
RELEASE_ID Unique id (ObjectId) of the release

Query examples

https://api.telecomx.dk/flexcare/appwhitelist/1234567890ABCD1234567890/release/1234567890ABCD1234657980

Response

The release is returned as a bare object. The app itself is not included.

JSON object
_id ObjectId Unique object id of the release
version String App version
versionCode Number Android version code (build number)
default Boolean True if this is chosen as the default version of the app
minAndroidVersion Number Minimum Android version required for this APK
file ObjectId File id of the APK (null if none)
fileName String File name of the APK. Present only when the file is found.
notes String Release notes for this version
releaseDate Date Date the version was added
bundle Array Additional files bundled with the APK
bundle[].file ObjectId File id of the bundled file
bundle[].url String URL of the bundled file
bundle[].fileName String File name of the bundled file. Present only when the file is found.

Example

{
  _id: "1234567890ABCD1234657980",
  version: "1.0",
  versionCode: 100,
  default: true,
  minAndroidVersion: 8,
  file: "1224657890ABCD1234567980",
  fileName: "Marathon V. 1.0",
  notes: "",
  releaseDate: "2026-05-01T10:00:00.000Z",
  bundle: [
    {
      file: "1234567890ABCD1234657890",
      url: "https://doc.telecomx.dk/1234567890ABCD1234657890",
      fileName: "marafun-assets.zip"
    }
  ]
}

Errors

Error code Message Description
422 id Invalid app id (must be a 24-character hex ObjectId).
422 releaseId Invalid release id (must be a 24-character hex ObjectId).
403 access_denied Insufficient access level, or the reseller admin lacks the TV employee feature.
404 id App not found.
404 releaseId Release not found on the app.
500 internal_error <Unspecified>