Table of Contents

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>