API : FlexCare : Device : List

Introduction

This request is used to return a list of FlexCare devices

Request

URL	https://api.telecomx.dk/flexcare/device
Method	GET
Access level	RESELLER_ADMIN
Query	offset	`[optional]` Index of the first device to return, default is 0.
	limit	`[optional]` The number of devices to return, default is 100
	filter	`[optional]` Used to filter results Fields searched: [name]
	customerId	`[optional]` If not given users own customer is used
	type	`[optional]` Type of devices to return values: 'STB', 'ANDROID_TABLET', 'ANDROID_BOX'
	showDevelopment	`[optional]` Boolean value of whether to include development devices
	full	`[optional]` Boolean value of whether to return full device object or simple object
	group	`[optional]` Unique id of a group
	heartbeatStatus	`[optional]` Heartbeat status of device values: 'DEAD', 'PRESUMEDDEAD', 'ALLOFFLINE', 'ONLINE'

Query examples

https://api.telecomx.dk/flexcare/device
https://api.telecomx.dk/flexcare/device?offset=25&limit=50&filter=something

Response

JSON Object
offset	Number	Index of the first device returned
limit	Number	Limit of devices returned
total	Number	Total amount of devices matching query
items	Array<DeviceListObject>	List of devices

DeviceListObject
_id	ObjectId	Unique id of the device
type	String	Type of device
androidType	String?	Type of android device, only if type is 'ANDROID'
applications	Array<AndroidApplication>	List of applications installed on the device, if type is not 'ANDROID' this is empty array
appsMissing	Array<String>	List of applications on the device that should be installed but is not, only if type is 'ANDROID'
appsOutdated	Array<String>	List of applications on the device that are outdated, only if type is 'ANDROID'
deviceId	String	Device id of the device
enabled	Boolean	Whether the device is enabled or not
info	DeviceInfo	Misc. info about device
name	String	Name of the device
tabletProfile	ObjectId	Unique id of the devices tablet profile, only if type is 'ANDROID'

DeviceInfo
androidVersion	String	Version of android on the device, only if type is 'ANDROID'
appVersion	String	Version of the android launcher if type is 'ANDROID', version of stb-launcher if not 'ANDROID'
lastComm	ISO Date	Last communication with device, null if no prior communication
lastUiComm	ISO Date	Last UI communication similar to lastComm, only if type is not 'ANDROID'

AndroidApplication
_id	String	Package name of the application
installed	Boolean	Whether application is installed on the device
name	String	Name of the application
versionCode	Number	Version code of the application
versionName	String	Name of the version f.eks. “1.21”

Example

{
    "offset": 0,
    "limit": 50,
    "total": 4,
    "items": [
        {
            "_id": "1234567890qwertyuiopqwer",
            "type": "ANDROID",
            "deviceId": "1701223",
            "name": "15.6\" Hjemme",
            "enabled": true,
            "info": {
                "lastComm": "2026-01-15T11:40:05.042Z",
                "lastUiComm": null,
                "model": "TC15",
                "androidVersion": "10",
                "appVersion": "211"
            },
            "tabletProfile": "1234567890qwertyuiopqwer",
            "applications": [
                {
                    "_id": "com.android.packageinstaller",
                    "name": "Pakkeinstallationsprogram",
                    "versionCode": 29,
                    "versionName": "10",
                    "installed": true
                }
            ],
            "appsMissing": [],
            "appsOutdated": [
                "Amazon Prime Video"
            ],
            "androidType": "ANDROID_TABLET"
        },
        {
            "_id": "1234567890qwertyuiopqwer",
            "type": "STB",
            "deviceId": "00:1A:79:73:AF:D1",
            "name": "MAG520, Arbejde",
            "enabled": true,
            "info": {
                "lastComm": "2026-01-16T10:45:01.676Z",
                "lastUiComm": "2026-01-16T10:16:57.472Z",
                "model": "MAG520",
                "androidVersion": null,
                "appVersion": "2.1.1",
                "hbversion": "3.5"
            },
            "tabletProfile": null,
            "applications": []
        },
        {
            "_id": "1234567890qwertyuiopqwer",
            "type": "STB",
            "deviceId": "00:1A:79:78:58:AF",
            "name": "MAG520, Hjemme",
            "enabled": true,
            "info": {
                "lastComm": "2025-11-27T14:27:12.424Z",
                "lastUiComm": "2025-11-27T14:27:12.423Z",
                "model": "MAG520",
                "androidVersion": null,
                "appVersion": "2.1.0"
            },
            "tabletProfile": null,
            "applications": []
        },
        {
            "_id": "1234567890qwertyuiopqwer",
            "type": "STB",
            "deviceId": "00:1A:79:39:2F:16",
            "name": "MAG250, hjemme",
            "enabled": true,
            "info": {
                "lastComm": "2025-12-03T12:53:19.933Z",
                "lastUiComm": "2025-12-03T12:53:19.933Z",
                "model": "MAG250",
                "androidVersion": null,
                "appVersion": "2.1.0"
            },
            "tabletProfile": null,
            "applications": []
        }
    ]
}

Errors

Error code	Message	Description
403	access_denied	Insufficient access level
500	internal_error	<Unspecified>

WIKI

Table of Contents

API : FlexCare : Device : List

Introduction

Request

Query examples

Response

Example

Errors