GET
/
organizations
/
{orgId}
/
devices
/
{deviceId}
curl --request GET \
  --url https://managexrapi.com/organizations/{orgId}/devices/{deviceId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "serial": "2G0YC1ZF630NZA",
  "name": "Device_0024",
  "mac": "CE:AF:07:47:E0:AE",
  "model": "Quest 3",
  "manufacturer": "Oculus",
  "notes": "With Taylor L",
  "batteryLevel": 34,
  "batteryIsCharging": true,
  "online": true,
  "osVersion": 12,
  "outOfDate": false,
  "pauseUpdates": false,
  "registerDate": "Tue, 27 Feb 2024 07:28:03 GMT",
  "updating": false,
  "factoryResetStatus": null,
  "firmwareVersion": "65.0.0.546.341",
  "configuration": {
    "name": "Test Configuration",
    "id": "OZ04csIYkA0EArkeu1vX"
  },
  "tags": [
    {
      "id": "sFidGmedeQofSBcvRcyn",
      "name": "History"
    }
  ],
  "tutorialModeEnabled": false,
  "kioskModeOverride": false,
  "lastSync": "Tue, 18 Jun 2024 21:46:34 GMT",
  "ram": {
    "available": 3704000512,
    "total": 8108634112
  },
  "location": {
    "city": "San Francisco",
    "region": "California",
    "country": "United States",
    "continent": "North America",
    "timeZone": "America/Los_Angeles",
    "latitude": 37,
    "longitude": -122
  },
  "connectedWifiNetwork": {
    "ssid": "TheElectricCity"
  },
  "storage": {
    "available": 107079929856
  }
}

Authorizations

​
Authorization
string
header
required

API key based authentication where <encoded-value> is the Base64 encoding of API_KEY_ID:API_KEY_SECRET

  • Username: The API Key ID.
  • Password: The API Key Secret.

Path Parameters

​
orgId
string
required

The ID of the organization. Locate the orgId under Organization Settings > API Keys.

​
deviceId
string
required

Unique identifier (serial number) of the device

Response

200 - application/json
A device object
​
serial
string

The serial number of the device. Also serves as the ID on ManageXR.

​
name
string

The name given to the device on ManageXR

​
mac
string

Device MAC address

​
model
string

Device model

​
manufacturer
string

Device manufacturer. Note, Meta devices report as Oculus

​
notes
string

The notes given to a device on ManageXR

​
batteryLevel
number

The battery level of the device

​
batteryIsCharging
boolean

True if the device is charging

​
online
boolean

True if the device is online

​
osVersion
string

The Android operating system version

​
outOfDate
boolean

True if device is not compliant with its configuration on ManageXR

​
pauseUpdates
boolean

True if configuration updates are paused for device. Pausing configuration updates stops a device from syncing with its latest Configuration. User-initiated changes to Configurations and ManageXR-initiated updates to the ManageXR Admin App and Home Screen will not propagate to devices with updates paused.

​
registerDate
string

Date the device was registered on ManageXR

​
updating
boolean

True if the device is currently downloading content or firmware

​
factoryResetStatus
enum<string>

This status is set when an admin sends a factory reset command to a device. Null if no factory reset command has been sent.

Available options:
QUEUED,
COMPLETE
​
firmwareVersion
string

Device firmware version

​
configuration
object

The configuration applied to the device on ManageXR

​
tags
any[]

The tags applied to the device on ManageXR. Null if device has no tags.

​
tutorialModeEnabled
boolean

True if device is in Tutorial Mode

​
kioskModeOverride
boolean

True if device has Kiosk Mode/ManageXR Home Screen disabled. When true, the device is not locked into the ManageXR Home Screen or Kiosk App and users have full access to the native system menus. Learn more

​
lastSync
string

The last time the device checked in with ManageXR. Online devices check in every 15 minutes.

​
ram
object

Device RAM in bytes

​
location
object

Device location as determined by its IP address and provided by ipstack.com

​
connectedWifiNetwork
object

Information about the last connected wifi network

​
storage
object

The available storage on the device in bytes

List DevicesEdit Device