Full representation of a device managed in ManageXR
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ManageXR API","colors":{"primary":"#7761E5","light":"#947FFF","dark":"#5840D2"},"logo":{"light":"https://mintcdn.com/managexr/qiYWKBHv4VQmUYkd/logo/mxr-light-bg.svg?fit=max\u0026auto=format\u0026n=qiYWKBHv4VQmUYkd\u0026q=85\u0026s=901be1c0efe5ce5c1fd2c5a1b75f3582","dark":"https://mintcdn.com/managexr/qiYWKBHv4VQmUYkd/logo/mxr-dark-bg.svg?fit=max\u0026auto=format\u0026n=qiYWKBHv4VQmUYkd\u0026q=85\u0026s=dfdc6111d6644f62a8b6251237f92524"},"favicon":"https://mintcdn.com/managexr/qiYWKBHv4VQmUYkd/mxr-fav.svg?fit=max\u0026auto=format\u0026n=qiYWKBHv4VQmUYkd\u0026q=85\u0026s=e616c98330eb5df0c57fec06efe59808","api":{"openapi":["openapi.yaml"]},"navbar":{"links":[{"href":"mailto:support@managexr.com","label":"Support"}],"primary":{"type":"button","label":"Sign In","href":"https://console.managexr.com/"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/managexr"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"managexr","hasAudioNarration":false,"actualSubdomain":"managexr","customDomains":["docs.managexr.com"],"gitSource":{"type":"github","owner":"managexr","repo":"public-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ada49a13f287dbf34ece172","collectionId":"bcaa2ca7-c7b0-46f0-b962-bb21e46fe749","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada49a13f287dbf34ece172"},"entitlements":{},"buildId":"6ada49a13f287dbf34ece172","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API","count":51},{"language":"default","tag":"Devices","count":14},{"language":"default","tag":"App Versions \u0026 Release Channels","count":11},{"language":"default","tag":"Configurations","count":9},{"language":"default","tag":"Library","count":6},{"language":"default","tag":"3D Environment SDK","count":5},{"language":"default","tag":"3D Environment SDK Reference","count":5},{"language":"default","tag":"Apps","count":5},{"language":"default","tag":"CLI","count":4},{"language":"default","tag":"Tags","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/v1/get-device","slug":"/api-reference/endpoint/v1/get-device","pageMetadata":{"title":"Get Device","openapi":"Get /v1/devices/{id}","description":"Retrieve a device by id (serial number)","href":"/api-reference/endpoint/v1/get-device"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve a device by id (serial number)\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Device","openapi":"Get /v1/devices/{id}","description":"Retrieve a device by id (serial number)","href":"/api-reference/endpoint/v1/get-device"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get device","description":"Retrieve a device by id (serial number)","parameters":["bff0c653-925e-47b2-b1a7-3fe8e317091e","297a050c-31fc-460f-82ab-c5327b6ddc94"],"responses":{"200":"ee4b2c79-3a4c-4083-9596-cf447cd4f7ae","403":"ed7859dd-2482-451c-9b31-f8e7fa8f5253","404":"bd527781-5138-46ac-bd1f-587b1fe41478"},"method":"get","type":"path","servers":["8c1b3124-3d83-42c2-b9d8-6c6d9bf66a02"],"security":["85f9a1bc-371a-4f34-bc78-4d6e87093391"],"path":"/v1/devices/{id}","baseUrlOptions":["https://managexrapi.com"],"title":"Get device","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"bff0c653-925e-47b2-b1a7-3fe8e317091e":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Unique identifier (serial number) of the device","uniqueKey":"","typeLabel":"string"},"description":"Unique identifier (serial number) of the device"},"297a050c-31fc-460f-82ab-c5327b6ddc94":{"name":"organizationId","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. \n\nDefaults to the organizationId associated with the API key.\n","uniqueKey":"","typeLabel":"string"},"description":"Unique identifier of the organization. This parameter is only necessary when using multi-organization API keys. \n\nDefaults to the organizationId associated with the API key.\n"}},"responses":{"ee4b2c79-3a4c-4083-9596-cf447cd4f7ae":{"description":"A device object","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"Full representation of a device managed in ManageXR","properties":{"id":{"type":"string","description":"The device ID (serial number)","example":"12345678901234","uniqueKey":"data.id","typeLabel":"string"},"serial":{"type":"string","description":"Device serial number","example":"12345678901234","uniqueKey":"data.serial","typeLabel":"string"},"name":{"type":"string","description":"The device name","example":"Training Room 1","uniqueKey":"data.name","typeLabel":"string"},"mac":{"type":"string","description":"MAC address of the device","example":"CE:AF:07:47:E0:AE","uniqueKey":"data.mac","typeLabel":"string"},"model":{"type":"string","description":"The device model","example":"Quest 2","uniqueKey":"data.model","typeLabel":"string"},"manufacturer":{"type":"string","description":"The device manufacturer","example":"Meta","uniqueKey":"data.manufacturer","typeLabel":"string"},"notes":{"type":"string","description":"Optional user-provided notes about the device","example":"Mounted in Room 5","uniqueKey":"data.notes","typeLabel":"string"},"batteryLevel":{"type":"number","description":"Battery level percentage","example":87,"uniqueKey":"data.batteryLevel","typeLabel":"number"},"batteryIsCharging":{"type":"boolean","description":"Whether the device is currently charging","example":true,"uniqueKey":"data.batteryIsCharging","typeLabel":"boolean"},"pauseUpdates":{"type":"boolean","description":"Whether updates are paused for this device","example":false,"uniqueKey":"data.pauseUpdates","typeLabel":"boolean"},"online":{"type":"boolean","description":"Whether the device is currently online","example":true,"uniqueKey":"data.online","typeLabel":"boolean"},"osVersion":{"type":"string","description":"The OS version running on the device","example":"Android 12","uniqueKey":"data.osVersion","typeLabel":"string"},"outOfDate":{"type":"boolean","description":"Whether the device is running outdated software","example":true,"uniqueKey":"data.outOfDate","typeLabel":"boolean"},"registerDate":{"type":"string","format":"date-time","description":"The date this device was registered with ManageXR","example":"2023-11-12T10:30:00Z","uniqueKey":"data.registerDate","typeLabel":"string\u003cdate-time>"},"updating":{"type":"boolean","description":"Whether the device is currently performing an update","example":false,"uniqueKey":"data.updating","typeLabel":"boolean"},"factoryResetStatus":{"type":"string","description":"Status of any pending or active factory reset","example":"NONE","uniqueKey":"data.factoryResetStatus","typeLabel":"string"},"firmwareVersion":{"type":"string","description":"Firmware version reported by the device","example":"Oculus OS 46.0.0.230","uniqueKey":"data.firmwareVersion","typeLabel":"string"},"configuration":{"type":"object","description":"The configuration assigned to this device","properties":{"id":{"type":"string","example":"sFidGmedeQofSBcvRcyn","uniqueKey":"data.configuration.id","typeLabel":"string"},"name":{"type":"string","example":"Training Configuration","uniqueKey":"data.configuration.name","typeLabel":"string"}},"uniqueKey":"data.configuration","typeLabel":"object"},"tags":{"type":"array","description":"Tags assigned to this device","items":{"type":"object","properties":{"id":{"type":"string","example":"tag_abc123","uniqueKey":"data.tags.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","example":"Lab Devices","uniqueKey":"data.tags.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"data.tags.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.tags","typeLabel":"object[]"},"tutorialModeEnabled":{"type":"boolean","description":"Whether tutorial mode is enabled","example":false,"uniqueKey":"data.tutorialModeEnabled","typeLabel":"boolean"},"kioskModeOverride":{"type":"boolean","description":"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](https://help.managexr.com/en/articles/5416931-temporarily-disable-kiosk-mode-home-screen)","example":true,"uniqueKey":"data.kioskModeOverride","typeLabel":"boolean"},"lastSync":{"type":"string","format":"date-time","description":"The last time the device checked in with ManageXR. Online devices check in every 15 minutes.","example":"2024-04-20T17:23:12Z","uniqueKey":"data.lastSync","typeLabel":"string\u003cdate-time>"},"ram":{"type":"object","description":"RAM usage info","properties":{"available":{"type":"number","description":"Available RAM in bytes","example":2147483648,"uniqueKey":"data.ram.available","typeLabel":"number"},"total":{"type":"number","description":"Total RAM in bytes","example":4294967296,"uniqueKey":"data.ram.total","typeLabel":"number"}},"uniqueKey":"data.ram","typeLabel":"object"},"storage":{"type":"object","description":"Internal storage usage info","properties":{"available":{"type":"number","description":"Available storage in bytes","example":15728640000,"uniqueKey":"data.storage.available","typeLabel":"number"}},"uniqueKey":"data.storage","typeLabel":"object"},"location":{"type":"object","description":"Approximate location of the device","properties":{"city":{"type":"string","example":"San Francisco","uniqueKey":"data.location.city","typeLabel":"string"},"region":{"type":"string","example":"California","uniqueKey":"data.location.region","typeLabel":"string"},"country":{"type":"string","example":"US","uniqueKey":"data.location.country","typeLabel":"string"},"continent":{"type":"string","example":"North America","uniqueKey":"data.location.continent","typeLabel":"string"},"timeZone":{"type":"string","example":"America/Los_Angeles","uniqueKey":"data.location.timeZone","typeLabel":"string"},"longitude":{"type":"number","example":-122.4194,"uniqueKey":"data.location.longitude","typeLabel":"number"},"latitude":{"type":"number","example":37.7749,"uniqueKey":"data.location.latitude","typeLabel":"number"}},"uniqueKey":"data.location","typeLabel":"object"},"connectedWifiNetwork":{"type":"object","description":"Current connected Wi-Fi network","properties":{"ssid":{"type":"string","example":"ManageXR-Office","uniqueKey":"data.connectedWifiNetwork.ssid","typeLabel":"string"}},"uniqueKey":"data.connectedWifiNetwork","typeLabel":"object"},"currentForegroundApp":{"type":"object","description":"Currently running app in the foreground","properties":{"packageName":{"type":"string","example":"com.my.app","uniqueKey":"data.currentForegroundApp.packageName","typeLabel":"string"},"title":{"type":"string","example":"My Training App","uniqueKey":"data.currentForegroundApp.title","typeLabel":"string"}},"uniqueKey":"data.currentForegroundApp","typeLabel":"object"},"controllerData":{"type":"object","description":"Data about connected controllers","properties":{"controller0":{"type":"object","properties":{"batteryLevel":{"type":"number","example":85,"uniqueKey":"data.controllerData.controller0.batteryLevel","typeLabel":"number"},"version":{"type":"string","example":"v14","uniqueKey":"data.controllerData.controller0.version","typeLabel":"string"}},"uniqueKey":"data.controllerData.controller0","typeLabel":"object"},"controller1":{"type":"object","properties":{"batteryLevel":{"type":"number","example":82,"uniqueKey":"data.controllerData.controller1.batteryLevel","typeLabel":"number"},"version":{"type":"string","example":"v14","uniqueKey":"data.controllerData.controller1.version","typeLabel":"string"}},"uniqueKey":"data.controllerData.controller1","typeLabel":"object"}},"uniqueKey":"data.controllerData","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"12345678901234","serial":"12345678901234","name":"Training Room 1","mac":"CE:AF:07:47:E0:AE","model":"Quest 2","manufacturer":"Meta","notes":"Mounted in Room 5","batteryLevel":87,"batteryIsCharging":true,"pauseUpdates":false,"online":true,"osVersion":"Android 12","outOfDate":true,"registerDate":"2023-11-12T10:30:00Z","updating":false,"factoryResetStatus":"NONE","firmwareVersion":"Oculus OS 46.0.0.230","configuration":{"id":"sFidGmedeQofSBcvRcyn","name":"Training Configuration"},"tags":[{"id":"tag_abc123","name":"Lab Devices"}],"tutorialModeEnabled":false,"kioskModeOverride":true,"lastSync":"2024-04-20T17:23:12Z","ram":{"available":2147483648,"total":4294967296},"storage":{"available":15728640000},"location":{"city":"San Francisco","region":"California","country":"US","continent":"North America","timeZone":"America/Los_Angeles","longitude":-122.4194,"latitude":37.7749},"connectedWifiNetwork":{"ssid":"ManageXR-Office"},"currentForegroundApp":{"packageName":"com.my.app","title":"My Training App"},"controllerData":{"controller0":{"batteryLevel":85,"version":"v14"},"controller1":{"batteryLevel":82,"version":"v14"}}}}}},"exampleType":"generated"}},"exampleType":"generated"},"ed7859dd-2482-451c-9b31-f8e7fa8f5253":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":403,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","example":"Forbidden","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","example":"ManageXR Error","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":403,"message":"Forbidden","error":"ManageXR Error"},"examples":{"Example":{"title":"Example","value":{"statusCode":403,"message":"Forbidden","error":"ManageXR Error"}}},"exampleType":"examples"}},"exampleType":"examples"},"bd527781-5138-46ac-bd1f-587b1fe41478":{"description":"Device not found","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","example":404,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","example":"Not found","uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","example":"ManageXR Error","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":404,"message":"Not found error","error":"ManageXR Error"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"message":"Not found error","error":"ManageXR Error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"85f9a1bc-371a-4f34-bc78-4d6e87093391":{"basicAuth":{"type":"http","scheme":"basic","description":"API key based authentication where \u003cencoded-value> is the Base64 encoding of `API_KEY_ID`:`API_KEY_SECRET`\n- **Username**: The API Key ID.\n- **Password**: The API Key Secret.\n","scopes":[],"schemeName":"basicAuth"}}},"servers":{"8c1b3124-3d83-42c2-b9d8-6c6d9bf66a02":{"url":"https://managexrapi.com","description":"ManageXR API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"API key based authentication where \u003cencoded-value> is the Base64 encoding of `API_KEY_ID`:`API_KEY_SECRET`\n- **Username**: The API Key ID.\n- **Password**: The API Key Secret.\n","scopes":[],"schemeName":"basicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"API key based authentication where \u003cencoded-value> is the Base64 encoding of `API_KEY_ID`:`API_KEY_SECRET`\n- **Username**: The API Key ID.\n- **Password**: The API Key Secret.\n","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"}],"title":"basicAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"managexr","siteName":"ManageXR API","title":"Get Device - ManageXR API","navMaps":{"firstHrefInVersion":{"API v1 (Latest)":{"href":"/api-reference/endpoint/v1/get-device","matchLevel":0},"API v0":{"href":"/api-reference/endpoint/list-devices","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-01-22T19:54:40.424Z","originalFileLocation":"api-reference/endpoint/v1/get-device.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve a device by id (serial number)\">\u003cmeta data-mint-head name=\"application-name\" content=\"ManageXR API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Device - ManageXR API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a device by id (serial number)\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ManageXR API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.managexr.com/api-reference/endpoint/v1/get-device\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://managexr.mintlify.app/_mintlify/api/og/v2?division=Devices\u0026amp;title=Get+Device\u0026amp;description=Retrieve+a+device+by+id+%28serial+number%29\u0026amp;theme=0c3589ddf1f5dd407e48a71d\u0026amp;signature=fcdf05565c3e8787e4de82e7b6f6473d99319142b00cf55fea7f1accde6214b8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Device - ManageXR API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a device by id (serial number)\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://managexr.mintlify.app/_mintlify/api/og/v2?division=Devices\u0026amp;title=Get+Device\u0026amp;description=Retrieve+a+device+by+id+%28serial+number%29\u0026amp;theme=0c3589ddf1f5dd407e48a71d\u0026amp;signature=fcdf05565c3e8787e4de82e7b6f6473d99319142b00cf55fea7f1accde6214b8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/managexr/EZRwaS1L27hi1b7T/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ManageXR API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7761E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.managexr.com/api-reference/endpoint/v1/get-device\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/v1/get-device.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.managexr.com/#organization\",\"name\":\"ManageXR API\",\"url\":\"https://docs.managexr.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/managexr/qiYWKBHv4VQmUYkd/logo/mxr-light-bg.svg?fit=max\u0026auto=format\u0026n=qiYWKBHv4VQmUYkd\u0026q=85\u0026s=901be1c0efe5ce5c1fd2c5a1b75f3582\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.managexr.com#website\",\"name\":\"ManageXR API\",\"url\":\"https://docs.managexr.com\",\"publisher\":{\"@id\":\"https://docs.managexr.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.managexr.com/api-reference/endpoint/v1/get-device#webpage\",\"url\":\"https://docs.managexr.com/api-reference/endpoint/v1/get-device\",\"name\":\"Get Device\",\"description\":\"Retrieve a device by id (serial number)\",\"dateModified\":\"2026-01-22T19:54:40.424Z\",\"isPartOf\":{\"@id\":\"https://docs.managexr.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.managexr.com/api-reference/endpoint/v1/get-device#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.managexr.com/api-reference/endpoint/v1/get-device#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Devices\",\"item\":\"https://docs.managexr.com/api-reference/endpoint/v1/list-devices\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Device\",\"item\":\"https://docs.managexr.com/api-reference/endpoint/v1/get-device\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.managexr.com/api-reference/endpoint/v1/get-device#apireference\",\"headline\":\"Get Device\",\"name\":\"Get Device\",\"description\":\"Retrieve a device by id (serial number)\",\"url\":\"https://docs.managexr.com/api-reference/endpoint/v1/get-device\",\"mainEntityOfPage\":{\"@id\":\"https://docs.managexr.com/api-reference/endpoint/v1/get-device#webpage\"},\"dateModified\":\"2026-01-22T19:54:40.424Z\",\"publisher\":{\"@id\":\"https://docs.managexr.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.managexr.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ManageXR API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ManageXR API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API","versions":[{"version":"API v1 (Latest)","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Devices","pages":[{"title":"List Devices","openapi":"Get /v1/devices/","description":"Retrieve a list of devices","href":"/api-reference/endpoint/v1/list-devices"},{"title":"Get Device","openapi":"Get /v1/devices/{id}","href":"/api-reference/endpoint/v1/get-device"},{"title":"List Device Sync Status","openapi":"Get /v1/devices/sync-status","description":"Retrieve sync status details for devices. Currently supports fetching app sync statuses (installed vs. target version) only.\n","href":"/api-reference/endpoint/v1/list-device-sync-status"},{"title":"Get Device Sync Status","openapi":"Get /v1/devices/{id}/sync-status","href":"/api-reference/endpoint/v1/get-device-sync-status"},{"title":"Edit Device","openapi":"Patch /v1/devices/{id}","href":"/api-reference/endpoint/v1/edit-device"},{"title":"Send Command","openapi":"Post /v1/devices/{id}/command","href":"/api-reference/endpoint/v1/send-command"},{"title":"Send Batch Command","openapi":"Post /v1/devices/batch-command","href":"/api-reference/endpoint/v1/batch-commands"},{"title":"Pause Updates","openapi":"Post /v1/devices/set-pause-updates","href":"/api-reference/endpoint/v1/set-pause-updates"}]},{"group":"Configurations","pages":[{"title":"List Configurations","openapi":"Get /v1/configurations/","href":"/api-reference/endpoint/v1/list-configurations"},{"title":"Get Configuration","openapi":"Get /v1/configurations/{id}","href":"/api-reference/endpoint/v1/get-configuration"},{"title":"Create Configuration","openapi":"Post /v1/configurations/","href":"/api-reference/endpoint/v1/create-configuration"},{"title":"Duplicate Configuration","openapi":"POST /v1/configurations/duplicate","href":"/api-reference/endpoint/v1/duplicate-configuration"},{"title":"Edit Configuration","openapi":"Patch /v1/configurations/{id}","href":"/api-reference/endpoint/v1/edit-configuration"},{"title":"Delete Configuration","openapi":"Delete /v1/configurations/{id}","href":"/api-reference/endpoint/v1/delete-configuration"}]},{"group":"Firmware","pages":[{"title":"List Firmware Versions","openapi":"Get /v1/firmware-versions","href":"/api-reference/endpoint/v1/list-firmware-versions"}]},{"group":"Apps","pages":[{"title":"List Apps","openapi":"Get /v1/apps/","href":"/api-reference/endpoint/v1/list-apps"},{"title":"Get App","openapi":"Get /v1/apps/{packageName}","href":"/api-reference/endpoint/v1/get-app"},{"title":"Create App","openapi":"Post /v1/apps/","href":"/api-reference/endpoint/v1/create-externally-hosted-app"},{"title":"Edit App","openapi":"PATCH /v1/apps/{packageName}","href":"/api-reference/endpoint/v1/edit-app"},{"title":"Delete App","openapi":"DELETE /v1/apps/{packageName}","href":"/api-reference/endpoint/v1/delete-app"}]},{"group":"App Versions \u0026 Release Channels","pages":[{"title":"List App Versions","openapi":"Get /v1/apps/{packageName}/versions","href":"/api-reference/endpoint/v1/list-app-versions"},{"title":"Get App Version","openapi":"Get /v1/apps/{packageName}/versions/{versionId}","href":"/api-reference/endpoint/v1/get-app-version"},{"title":"Create App Version","openapi":"Post /v1/apps/{packageName}/versions","href":"/api-reference/endpoint/v1/create-app-version"},{"title":"Edit App Version","openapi":"Patch /v1/apps/{packageName}/versions/{versionId}","href":"/api-reference/endpoint/v1/edit-app-version"},{"title":"Delete App Version","openapi":"Delete /v1/apps/{packageName}/versions/{versionId}","href":"/api-reference/endpoint/v1/delete-app-version"},{"title":"List Release Channels","openapi":"Get /v1/apps/{packageName}/release-channels","href":"/api-reference/endpoint/v1/list-app-release-channels"},{"title":"Create Release Channel","openapi":"Post /v1/apps/{packageName}/release-channels","href":"/api-reference/endpoint/v1/create-app-release-channel"},{"title":"Edit Release Channel","openapi":"Patch /v1/apps/{packageName}/release-channels/{releaseChannelId}","href":"/api-reference/endpoint/v1/edit-app-release-channel"},{"title":"Share Release Channel","openapi":"Post /v1/apps/{packageName}/release-channels/{releaseChannelId}/share","href":"/api-reference/endpoint/v1/share-app-release-channel"},{"title":"Unshare Release Channel","openapi":"Post /v1/apps/{packageName}/release-channels/{releaseChannelId}/unshare","href":"/api-reference/endpoint/v1/unshare-app-release-channel"},{"title":"Delete Release Channel","openapi":"Delete /v1/apps/{packageName}/release-channels/{releaseChannelId}","href":"/api-reference/endpoint/v1/delete-app-release-channel"}]},{"group":"Library","pages":[{"title":"List Files","openapi":"Get /v1/files/","href":"/api-reference/endpoint/v1/list-files"},{"title":"Create Files","openapi":"Post /v1/files/","href":"/api-reference/endpoint/v1/create-files"},{"title":"List Wi-Fi Networks","openapi":"Get /v1/wifi-networks","href":"/api-reference/endpoint/v1/list-wifi-networks"},{"title":"Create Wi-Fi Network","openapi":"Post /v1/wifi-networks","href":"/api-reference/endpoint/v1/create-wifi-network"},{"title":"List Videos","openapi":"Get /v1/videos","href":"/api-reference/endpoint/v1/list-videos"},{"title":"List WebXR Links","openapi":"Get /v1/links","href":"/api-reference/endpoint/v1/list-links"}]},{"group":"Tags","pages":[{"title":"Create Tag","openapi":"Post /v1/tags/","href":"/api-reference/endpoint/v1/create-tag"},{"title":"Edit Tag","openapi":"PATCH /v1/tags/{tagId}","href":"/api-reference/endpoint/v1/edit-tag"},{"title":"Delete Tag","openapi":"DELETE /v1/tags/{tagId}","href":"/api-reference/endpoint/v1/delete-tag"}]},{"group":"Organizations","pages":[{"title":"List Organizations","openapi":"GET /organizations","href":"/api-reference/endpoint/list-organizations"}]}]},{"version":"API v0","pages":[{"title":"API v0","href":"/api-reference/endpoint/list-devices"}]}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli-reference/introduction"}]},{"tab":"Device SDK","pages":[{"title":"Device SDK","href":"/sdk-reference/introduction"}]},{"tab":"3D Environment SDK","pages":[{"title":"3D Environment SDK","href":"/3d-environment-sdk-reference/introduction"}]},{"tab":"Streaming SDK","pages":[{"title":"Streaming SDK","href":"/streaming-sdk-reference/introduction"}]}]},"basePath":"","title":"Get Device - ManageXR API","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}