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
Param	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>

WIKI

Table of Contents