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.

Example:

"2G0YC1ZF630NZA"

​
name
string

The name given to the device on ManageXR

Example:

"Device_0024"

​
mac
string

Device MAC address

Example:

"CE:AF:07:47:E0:AE"

​
model
string

Device model

Example:

"Quest 3"

​
manufacturer
string

Device manufacturer. Note, Meta devices report as Oculus

Example:

"Oculus"

​
notes
string

The notes given to a device on ManageXR

Example:

"With Taylor L"

​
batteryLevel
number

The battery level of the device

Example:

34

​
batteryIsCharging
boolean

True if the device is charging

Example:

true

​
online
boolean

True if the device is online

Example:

true

​
osVersion
string

The Android operating system version

Example:

12

​
outOfDate
boolean

True if device is not compliant with its configuration on ManageXR

Example:

false

​
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.

Example:

false

​
registerDate
string

Date the device was registered on ManageXR

Example:

"Tue, 27 Feb 2024 07:28:03 GMT"

​
updating
boolean

True if the device is currently downloading content or firmware

Example:

false

​
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
Example:

null

​
firmwareVersion
string

Device firmware version

Example:

"65.0.0.546.341"

​
configuration
object

The configuration applied to the device on ManageXR

Example:
{
  "name": "Test Configuration",
  "id": "OZ04csIYkA0EArkeu1vX"
}
​
tags
any[]

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

Example:
[
  {
    "id": "sFidGmedeQofSBcvRcyn",
    "name": "History"
  }
]
​
tutorialModeEnabled
boolean

True if device is in Tutorial Mode

Example:

false

​
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

Example:

false

​
lastSync
string

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

Example:

"Tue, 18 Jun 2024 21:46:34 GMT"

​
ram
object

Device RAM in bytes

Example:
{
  "available": 3704000512,
  "total": 8108634112
}
​
location
object

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

Example:
{
  "city": "San Francisco",
  "region": "California",
  "country": "United States",
  "continent": "North America",
  "timeZone": "America/Los_Angeles",
  "latitude": 37,
  "longitude": -122
}
​
connectedWifiNetwork
object

Information about the last connected wifi network

Example:
{ "ssid": "TheElectricCity" }
​
storage
object

The available storage on the device in bytes

Example:
{ "available": 107079929856 }