Get device data

GET 
/api/v2/device

Retrieves complete device information including enrollment configuration (server URLs, authentication) and metadata (name, location, storage, operational status).

Request

Responses

200

application/json

Schema

Schema

deliverySource DeliverySourcerequired

Possible values: [cache, remote]

deviceId stringrequired

Device identifier

deviceType string[]required

Device type tokens

platform stringnullable

Platform name

platformId stringnullable

Platform identifier

urlGetAppServerAvailable string[]nullable

Available GetApp server URLs

metadata

object

nullable

required

Device - MetaData: Physical and logical device properties

battery

object

nullable

Comprehensive battery status information

health int32nullable

Battery health as a percentage (0-100), based on current capacity vs design capacity

isPluggedIn booleannullable

Whether the device is plugged into power (charging or full)

isVirtual booleannullable

Whether this is a virtual/emulated battery (e.g., in VM)

level int32required

Battery level as a percentage (0-100)

state stringrequired

Battery state description (Charging, Discharging, Full, Empty, Unknown)

timeRemainingMinutes int32nullable

Estimated time remaining in minutes (for discharge or charge)

location

object

nullable

alt stringnullable

lat stringrequired

long stringrequired

macAddress stringnullable

MAC address

name stringnullable

Device name

os stringnullable

Operating system

osRelease stringnullable

OS release version

storageAvailable int64nullable

Available storage in bytes

urlGetAppServerActive stringrequired

Currently active GetApp server URL

Example (from schema)

{
  "deliverySource": "cache",
  "deviceId": "string",
  "deviceType": [
    "string"
  ],
  "platform": "string",
  "platformId": "string",
  "urlGetAppServerAvailable": [
    "string"
  ],
  "metadata": {
    "battery": {
      "health": 0,
      "isPluggedIn": true,
      "isVirtual": true,
      "level": 0,
      "state": "string",
      "timeRemainingMinutes": 0
    },
    "location": {
      "alt": "string",
      "lat": "string",
      "long": "string"
    },
    "macAddress": "string",
    "name": "string",
    "os": "string",
    "osRelease": "string",
    "storageAvailable": 0,
    "urlGetAppServerActive": "string"
  }
}

Loading...