This API offers the following features:
\nFind Device by IMEI
\nGet the last known location for a device
\nSuspend/Unsuspend device
\nClear the device passcode
\nLock the device
\nReboot a device
\nErase a device
\nThings that the developers should know about
\nAll API calls should begin with the URL: https://api.ensemblemdm.com/v1
So, an example of calling our API should look like this:
\nGET https://api.ensemblemdm.com/v1/usageInteracting with the API requires sending an 'x-api-key' header with each request. To retrieve an API Key, please reach out to us at engineering@conversasolutions.com
\nheader['x-api-key'] = API_KEY\n\nNOTE API Keys are unavailable at the moment.
\nWe use conventional HTTP response codes to indicate the success or failure of an API request.
\n2xx range: success
4xx range: error that failed given the information provided
5xx range: error with our servers (these are rare).
Everything worked as expected.
\nThe request was unacceptable, often due to missing a required parameter or if data you provided fails validation. Check our documentation to confirm that the data type you are sending matches what our server expects.
\nThere was an error on our end. This should be rare, so please reach out to us if you continue to receive these status codes.
\nYes. No more than 1000 requests every 100 seconds
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction","slug":"introduction"},{"content":"Overview","slug":"overview"},{"content":"Base URL","slug":"base-url"},{"content":"Authentication","slug":"authentication"},{"content":"Status Codes","slug":"status-codes"},{"content":"Rate limit","slug":"rate-limit"}],"owner":"39577996","collectionId":"3a2fc1dd-f626-4622-8409-5a6f883ff807","publishedId":"2sAYBSkDMu","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"42b0ff"},"publishDate":"2024-11-21T16:10:50.000Z"},"item":[{"name":"/usage","id":"205ef2af-a2d5-4e66-b6b8-2315ff118b3d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"/usage?limit=10&page=2&sort='asc'&to='2021-07-18'&from='2021-07-18'","description":"Get all the usage data for the API KEY specified in the request header x-api-key
\n","urlObject":{"path":["usage"],"query":[{"description":{"content":"Optional. Limits the number of usage objects returned per page. If not provided, a default (and maximum) of 100 items is used. Must be an integer from 1-100.
\n","type":"text/plain"},"key":"limit","value":"10"},{"description":{"content":"Optional. Indicates which \"page\" of data to return. Must be an integer.
\n","type":"text/plain"},"key":"page","value":"2"},{"description":{"content":"Optional. By default, 'desc' is the sort order: with the most recent usage at the beginning of the list. Only accepts \"asc\" (ascending) or \"desc\" (descending).
\n","type":"text/plain"},"key":"sort","value":"'asc'"},{"description":{"content":"Optional. Must be a date string in ISO8601 format. If provided, no usage data that was captured after this date will be returned.
\n","type":"text/plain"},"key":"to","value":"'2021-07-18'"},{"description":{"content":"Optional. Must be a date string in ISO8601 format. If provided, no usage data that was captured before this date will be returned.
\n","type":"text/plain"},"key":"from","value":"'2021-07-18'"}],"variable":[]}},"response":[{"id":"37645b19-7a37-4fca-ba29-431ccc5d3ebc","name":"Base request","originalRequest":{"method":"GET","header":[],"url":"/usage"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"data\": {\n \"usage\": [\n {\n \"timestamp\": \"2021-07-19T20:37:30.208Z\",\n \"request\": {\n \"url\": \"/location/1234\",\n \"body\": null,\n \"complete\": true,\n \"userAgent\": \"Mozilla/5.0 (Windows NT 10.0)\",\n \"queryParams\": null,\n \"method\": \"GET\",\n \"ip\": \"127.0.0.1\"\n },\n \"response\": {\n \"statusCode\": 404,\n \"statusMessage\": \"Not Found\"\n }\n }\n ],\n \"total\": 1,\n \"page\": 1,\n \"totalPages\": 1\n }\n}"},{"id":"f47448fa-7e06-4714-bd99-029775be33d4","name":"With query params","originalRequest":{"method":"GET","header":[],"url":{"raw":"/usage?limit=10&page=2&sort='asc'&to='2021-07-19'&from='2021-07-19'","path":["usage"],"query":[{"key":"limit","value":"10","description":"Optional. How much usage data to return. The default and maximum is 100."},{"key":"page","value":"2"},{"key":"sort","value":"'asc'"},{"key":"to","value":"'2021-07-19'"},{"key":"from","value":"'2021-07-19'"}]}},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"data\": {\n \"usage\": [\n {\n \"timestamp\": \"2021-07-19T20:37:30.208Z\",\n \"request\": {\n \"url\": \"/location/1234\",\n \"body\": null,\n \"complete\": true,\n \"userAgent\": \"Mozilla/5.0 (Windows NT 10.0)\",\n \"queryParams\": null,\n \"method\": \"GET\",\n \"ip\": \"127.0.0.1\"\n },\n \"response\": {\n \"statusCode\": 404,\n \"statusMessage\": \"Not Found\"\n }\n }\n ],\n \"total\": 1,\n \"page\": 1,\n \"totalPages\": 1\n }\n}"}],"_postman_id":"205ef2af-a2d5-4e66-b6b8-2315ff118b3d"},{"name":"/location/:serial","id":"97e56faf-3d1b-4ce4-93b8-600eb632eaa3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"/location/:serial","description":"Gets the last known location for the requested device.
\nNOTE After 90 days, we remove device location data from our servers.
\n","urlObject":{"path":["location",":serial"],"query":[],"variable":[{"id":"7d62c3a9-3b82-406a-9c11-dad2ebf1c84b","description":{"content":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number.
\n","type":"text/plain"},"type":"any","value":"351756051523999","key":"serial"}]}},"response":[{"id":"215cc540-b666-4af9-b484-a02e42f3a0c2","name":"200 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/location/:serial","path":["location",":serial"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"data\": {\n \"latitude\": 39.74926691875779,\n \"longitude\": -105.00781737670295,\n \"time\": 1626122282591\n }\n}"},{"id":"b8ea4bea-4143-4997-9428-733f85381f5e","name":"404 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/location/:serial","path":["location",":serial"],"variable":[{"key":"serial","value":"1234","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Device or location not found\"\n}"},{"id":"7e1cd4bd-0f04-4566-a779-2ce7f2e06c2b","name":"400 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/location/:serial","path":["location",":serial"],"variable":[{"key":"serial","value":"!@bad","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"errors\": [ \"serial: Invalid value (!@bad)\" ] }"}],"_postman_id":"97e56faf-3d1b-4ce4-93b8-600eb632eaa3"},{"name":"/devices/:serial","id":"76987073-661c-4fbb-be5c-824f9f4718c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"/devices/:serial","description":"Gets information about the requested device.
\n","urlObject":{"path":["devices",":serial"],"query":[],"variable":[{"id":"8419a385-fccf-40d4-925e-0a731effe798","description":{"content":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number.
\n","type":"text/plain"},"type":"any","value":"351756051523999","key":"serial"}]}},"response":[{"id":"2a7a5cf5-b3d7-48e9-9d2c-8177b3b54c30","name":"200 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial","path":["devices",":serial"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"data\": {\n \"serials\": {\n \"imei\": [ \"351756051523999\" ],\n \"meid\": [ \"35175605152399\" ],\n \"meidD\": [ \"089072179701385369\" ],\n \"adb\": \"123456789\",\n \"mechanical\": \"Z2056\"\n },\n \"suspension\": {\n \"status\": \"Off\",\n \"pin\": null,\n \"time\": \"2025-02-26T17:37:10.190Z\"\n },\n \"status\": { \n \"status\": \"No Data\", \n \"msg\": \"This device has never checked-in.\"\n },\n \"hardwareInfo\": {\n \"activeCpuUsage\": [],\n \"totalCpuUsage\": [],\n \"cpuTemperatures\": [],\n \"batteryTemperatures\": [],\n \"gpuTemperatures\": [],\n \"skinTemperatures\": []\n },\n \"alias\": \"alias\",\n \"manufacturer\": \"samsung\",\n \"model\": \"\",\n \"brand\": \"\",\n \"security_patch\": \"\",\n \"os\": \"\",\n \"clientVersion\": 0,\n \"registrationDate\": \"2021-07-29T17:43:42.759Z\",\n \"platform\": \"Android\",\n \"adminType\": \"Device Owner\",\n \"managedType\": \"Fully Managed\",\n \"battery\": {\n \"health\": \"good\",\n \"percentage\": 100,\n \"timestamp\": \"2025-02-25T21:53:57.645Z\"\n },\n \"systemUpdateStatus\": {\n \"status\": \"Up to Date\",\n \"msg\": \"There are no pending system updates.\"\n },\n \"subscriptionInfo\": [\n {\n \"carrierName\": \"Emergency calls only\",\n \"displayName\": \"AT&T\",\n \"mcc\": \"310\",\n \"mnc\": \"280\",\n \"guid\": \"FFFF\",\n \"iccId\": \"890128L333156000XXXX\",\n \"number\": \"Unknown\",\n \"countryCode\": \"US\"\n }\n ]\n }\n}"},{"id":"88dfe371-eeed-4ba8-951d-93c8a78c919f","name":"404 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial","path":["devices",":serial"],"variable":[{"key":"serial","value":"1234","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Device not found\"\n}"},{"id":"2cc46115-a89a-42e0-bad3-aab408ac1b84","name":"400 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial","path":["devices",":serial"],"variable":[{"key":"serial","value":"!@bad","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"errors\": [ \"serial: Invalid value (!@bad)\" ] }"},{"id":"c2c81fbd-d182-49e4-9e5a-14adf2903626","name":"500 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial","path":["devices",":serial"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"message\": \"Unexpected issue while looking up device.\" }"}],"_postman_id":"76987073-661c-4fbb-be5c-824f9f4718c0"},{"name":"/devices/:serial/suspend","id":"a39bfcd9-6c45-4da9-8cb9-a137698d4dd2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"/devices/:serial/suspend","description":"Sends a SUSPEND command to the device with the matching serial number. Once the device receives the command (it needs to have a data connection), it will then be in a \"suspended\" state. A suspended device is locked for use until it is \"unsuspended\" (see the /unsuspend endpoint).
This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number.
\n","type":"text/plain"},"type":"any","value":"351756051523999","key":"serial"}]}},"response":[{"id":"f9f062d2-2f03-4a08-bbae-3f24ec81f360","name":"200 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial/suspend","path":["devices",":serial","suspend"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"msg\": \"Device SUSPEND message sent.\"\n}"},{"id":"a783f26c-9350-4743-b214-57f1ebc7c5f2","name":"404 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial/suspend","path":["devices",":serial","suspend"],"variable":[{"key":"serial","value":"1234","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Device cannot be reached at the moment. If this problem persists, contact Customer Support.\"\n}"},{"id":"c782a659-a6c9-4503-9944-cb62ef5b26ed","name":"400 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial/suspend","path":["devices",":serial","suspend"],"variable":[{"key":"serial","value":"!@bad","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"errors\": [ \"serial: Invalid value (!@bad)\" ] }"},{"id":"0649c561-7f93-4115-91ab-ec32bd8fdb03","name":"500 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial/suspend","path":["devices",":serial","suspend"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Unexpected issue while looking up device.\"\n}"}],"_postman_id":"a39bfcd9-6c45-4da9-8cb9-a137698d4dd2"},{"name":"/devices/:serial/unsuspend","id":"a72e1e3c-b7ac-48d1-8b2d-c0a1ba2c15e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"/devices/:serial/unsuspend","description":"Sends an UNSUSPEND command to the device with the matching serial number. Once the device receives the command (it needs to have a data connection), it will then be in an \"unsuspended\" state. An unsuspended device is available for normal use.
\n","urlObject":{"path":["devices",":serial","unsuspend"],"query":[],"variable":[{"id":"617bee8d-f9e1-434c-b8dd-1bb721d9cde5","description":{"content":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number.
\n","type":"text/plain"},"type":"any","value":"351756051523999","key":"serial"}]}},"response":[{"id":"39ab191b-74fd-4fe5-81c3-14553445d16e","name":"200 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial/unsuspend","path":["devices",":serial","unsuspend"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"msg\": \"Device UNSUSPEND message sent.\"\n}"},{"id":"a0e736ab-8286-4f9e-8cde-2469db6a0734","name":"404 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial/unsuspend","path":["devices",":serial","unsuspend"],"variable":[{"key":"serial","value":"1234","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Device cannot be reached at the moment. If this problem persists, contact Customer Support.\"\n}"},{"id":"dd1db1f1-cd05-4fd6-853a-bd8abceee804","name":"400 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial/unsuspend","path":["devices",":serial","unsuspend"],"variable":[{"key":"serial","value":"!@bad","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"errors\": [ \"serial: Invalid value (!@bad)\" ] }"},{"id":"b85f0a97-d901-4b6d-9319-506682dbc0f4","name":"500 Status Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"/devices/:serial/unsuspend","path":["devices",":serial","unsuspend"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Unexpected issue while looking up device.\"\n}"}],"_postman_id":"a72e1e3c-b7ac-48d1-8b2d-c0a1ba2c15e7"},{"name":"/devices/:serial/clear-passocde","id":"af3b2a63-5965-4514-adc2-4da0e15d8f04","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"/devices/:serial/clear-passcode","description":"Sends a CLEAR_PASSCODE command to the device with the matching serial number. Once the device receives the command (it needs to have a data connection), it will remove the passcode if one was set.
\nNote: this command is only supported on Android devices
\n","urlObject":{"path":["devices",":serial","clear-passcode"],"query":[],"variable":[{"id":"617bee8d-f9e1-434c-b8dd-1bb721d9cde5","description":{"content":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number.
\n","type":"text/plain"},"type":"any","value":"351756051523999","key":"serial"}]}},"response":[{"id":"4355aa9c-5190-4b6e-b5d1-b457a9976d21","name":"200 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/clear-passcode","path":["devices",":serial","clear-passcode"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"msg\": \"Device CLEAR_PASSCODE message sent.\"\n}"},{"id":"a563817e-66dd-4460-bd5f-0a579094894e","name":"404 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/clear-passcode","path":["devices",":serial","clear-passcode"],"variable":[{"key":"serial","value":"1234","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Device cannot be reached at the moment. If this problem persists, contact Customer Support.\"\n}"},{"id":"1146f1a7-e30a-42b6-93a0-2c00dc5bbd67","name":"400 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/clear-passcode","path":["devices",":serial","clear-passcode"],"variable":[{"key":"serial","value":"!@bad","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"errors\": [ \"serial: Invalid value (!@bad)\" ] }"},{"id":"9375d5d6-959c-4e77-a6b9-6ff9b8f0bea4","name":"500 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/clear-passcode","path":["devices",":serial","clear-passcode"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Unexpected issue while sending command to device. If this issue persists, please contact support.\"\n}"}],"_postman_id":"af3b2a63-5965-4514-adc2-4da0e15d8f04"},{"name":"/devices/:serial/lock","id":"f4b3fde5-c89b-4bfc-b610-b523fb2ba3ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"/devices/:serial/lock","description":"Sends a LOCK command to the device with the matching serial number. Once the device receives the command (it needs to have a data connection), it will apply the lock screen if one was set.
\n","urlObject":{"path":["devices",":serial","lock"],"query":[],"variable":[{"description":{"content":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number.
\n","type":"text/plain"},"type":"any","value":"351756051523999","key":"serial"}]}},"response":[{"id":"8e5cd106-95a3-4548-8d77-ba14f7e2e05b","name":"200 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/lock","path":["devices",":serial","lock"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"msg\": \"Device LOCK message sent.\"\n}"},{"id":"fff088ef-7823-4f34-9fbf-1c017eb313a1","name":"404 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/lock","path":["devices",":serial","lock"],"variable":[{"key":"serial","value":"1234","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Device cannot be reached at the moment. If this problem persists, contact Customer Support.\"\n}"},{"id":"4eb87bed-96e6-4019-99e5-0f430e1b1508","name":"400 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/lock","path":["devices",":serial","lock"],"variable":[{"key":"serial","value":"!@bad","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"errors\": [ \"serial: Invalid value (!@bad)\" ] }"},{"id":"3c4a8aa6-b156-490b-9d0e-6c0db2c4d276","name":"500 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/lock","path":["devices",":serial","lock"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Unexpected issue while sending command to device. If this issue persists, please contact support.\"\n}"}],"_postman_id":"f4b3fde5-c89b-4bfc-b610-b523fb2ba3ab"},{"name":"/devices/:serial/reboot","id":"9b98859d-4ca0-4cac-b69a-47ddb2b0e539","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"/devices/:serial/reboot","description":"Sends a REBOOT command to the device with the matching serial number. Once the device receives the command (it needs to have a data connection), it will power off and then power on.
\n","urlObject":{"path":["devices",":serial","reboot"],"query":[],"variable":[{"description":{"content":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number.
\n","type":"text/plain"},"type":"any","value":"351756051523999","key":"serial"}]}},"response":[{"id":"2f65a38f-7be4-4bc9-8baa-1684e9ddc019","name":"200 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/reboot","path":["devices",":serial","reboot"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"msg\": \"Device REBOOT message sent.\"\n}"},{"id":"8fc09e62-75b6-4180-a49d-a71edca53ca9","name":"404 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/reboot","path":["devices",":serial","reboot"],"variable":[{"key":"serial","value":"1234","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Device cannot be reached at the moment. If this problem persists, contact Customer Support.\"\n}"},{"id":"cfe0c5b0-2517-44b6-8237-6ddb3b2a363e","name":"400 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/reboot","path":["devices",":serial","reboot"],"variable":[{"key":"serial","value":"!@bad","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"errors\": [ \"serial: Invalid value (!@bad)\" ] }"},{"id":"98732fe3-919c-40e8-9f1e-e7fd2e5612e0","name":"500 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/reboot","path":["devices",":serial","reboot"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Unexpected issue while sending command to device. If this issue persists, please contact support.\"\n}"}],"_postman_id":"9b98859d-4ca0-4cac-b69a-47ddb2b0e539"},{"name":"/devices/:serial/erase","id":"741d39b8-8314-499c-b1dd-5614a57a9042","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"/devices/:serial/erase","description":"Sends a ERASE command to the device with the matching serial number. Once the device receives the command (it needs to have a data connection), it will clear all data from the device and return it to it's factory settings.
\n","urlObject":{"path":["devices",":serial","erase"],"query":[],"variable":[{"description":{"content":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number.
\n","type":"text/plain"},"type":"any","value":"351756051523999","key":"serial"}]}},"response":[{"id":"60a468fe-1136-48d0-8892-f1c35437821d","name":"200 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/erase","path":["devices",":serial","erase"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"msg\": \"Device ERASE message sent.\"\n}"},{"id":"94ba9444-6449-4881-8f55-b4397c1d1821","name":"404 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/erase","path":["devices",":serial","erase"],"variable":[{"key":"serial","value":"1234","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Device cannot be reached at the moment. If this problem persists, contact Customer Support.\"\n}"},{"id":"e39694ea-fce3-4516-8d43-5d2f0c8c610e","name":"400 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/erase","path":["devices",":serial","erase"],"variable":[{"key":"serial","value":"!@bad","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{ \"success\": false, \"errors\": [ \"serial: Invalid value (!@bad)\" ] }"},{"id":"55465061-d3de-4e89-b950-a6da2dae99ba","name":"500 Status Response","originalRequest":{"method":"POST","header":[],"url":{"raw":"/devices/:serial/erase","path":["devices",":serial","erase"],"variable":[{"key":"serial","value":"351756051523999","description":"This can be the device's 15-digit IMEI, the 14-digit hexadecimal MEID, the 18-digit decimal MEID, or an alphanumeric mechanical serial number."}]}},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Unexpected issue while sending command to device. If this issue persists, please contact support.\"\n}"}],"_postman_id":"741d39b8-8314-499c-b1dd-5614a57a9042"}],"event":[{"listen":"prerequest","script":{"id":"79ef42e5-3d12-40c4-9898-22098cf96609","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"86c8971d-2685-40e7-b1e3-ebfdefdc2841","type":"text/javascript","exec":[""]}}]}