{"_id":"59e70b9ee027ae002e7d2eec","category":{"_id":"59e70b9ee027ae002e7d2ed6","version":"59e70b9ee027ae002e7d2ed2","project":"5496d393f52a630b00519cdd","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-12-21T18:05:46.941Z","from_sync":false,"order":3,"slug":"rest-api","title":"REST API"},"user":"5496d353f52a630b00519cdc","parentDoc":null,"project":"5496d393f52a630b00519cdd","version":{"_id":"59e70b9ee027ae002e7d2ed2","project":"5496d393f52a630b00519cdd","__v":2,"createdAt":"2017-10-18T08:06:54.462Z","releaseDate":"2017-10-18T08:06:54.462Z","categories":["59e70b9ee027ae002e7d2ed3","59e70b9ee027ae002e7d2ed4","59e70b9ee027ae002e7d2ed5","59e70b9ee027ae002e7d2ed6","59e70b9ee027ae002e7d2ed7","59e70b9ee027ae002e7d2ed8","59e70b9ee027ae002e7d2ed9","59e70b9ee027ae002e7d2eda","59e70b9ee027ae002e7d2edb","59e70b9ee027ae002e7d2edc","59e70b9ee027ae002e7d2edd","59e70b9ee027ae002e7d2ede","59e70b9ee027ae002e7d2edf","5b8661ccdd19310003a3fa0b"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"2.0.10","version":"2.0.10"},"githubsync":"","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-12-22T07:43:05.363Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","examples":{"codes":[]},"method":"get","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Parameters\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Relevant only for User_ID queries.\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Field\",\n    \"h-1\": \"Descriotion\",\n    \"h-2\": \"Type\",\n    \"h-3\": \"Example\",\n    \"0-0\": \"active_since\\n*(optional)*\",\n    \"0-1\": \"Filters results to devices that were active since a specific date.\",\n    \"0-2\": \"YYYY-MM-DD\",\n    \"0-3\": \"2013-12-25\"\n  },\n  \"cols\": 4,\n  \"rows\": 1\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Response\"\n}\n[/block]\nResponse contains the following structure:\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"device_id\",\n    \"h-0\": \"Field\",\n    \"1-0\": \"details\",\n    \"1-1\": \"The data of devices that match the query.\",\n    \"0-1\": \"The device id.\",\n    \"0-2\": \"String\",\n    \"0-3\": \"e0fc05c3478926023a8607029f012f9f62bb4590\",\n    \"h-3\": \"Example\",\n    \"h-2\": \"Type\",\n    \"h-1\": \"Description\",\n    \"1-2\": \"See [Device Details](doc:device-details) Structure\"\n  },\n  \"cols\": 4,\n  \"rows\": 2\n}\n[/block]","excerpt":"1 -  HTTPS api.placer.io/v2/apps/**APP_KEY**/users/**USER_ID**\n\n2 -  HTTPS api.placer.io/v2/apps/**APP_KEY**/devices/**DEVICE_ID**\n\n*Device details provides basic information, such as: user_id, creation time, status, etc. Please notice that the response structure for each element is similar to the response elements in the [Devices](doc:devices) API.*\n\nPlacer’s device details are related to device_id. If user_id is used for query (the first query URL template), results will be returned as a list of related device_ids with details for each device. For further details see [User_ID & Device_ID](doc:user_id--device_id) .","slug":"device-details-1","type":"endpoint","title":"Details"}

getDetails

1 - HTTPS api.placer.io/v2/apps/**APP_KEY**/users/**USER_ID** 2 - HTTPS api.placer.io/v2/apps/**APP_KEY**/devices/**DEVICE_ID** *Device details provides basic information, such as: user_id, creation time, status, etc. Please notice that the response structure for each element is similar to the response elements in the [Devices](doc:devices) API.* Placer’s device details are related to device_id. If user_id is used for query (the first query URL template), results will be returned as a list of related device_ids with details for each device. For further details see [User_ID & Device_ID](doc:user_id--device_id) .

[block:api-header] { "type": "basic", "title": "Parameters" } [/block] [block:callout] { "type": "warning", "body": "Relevant only for User_ID queries." } [/block] [block:parameters] { "data": { "h-0": "Field", "h-1": "Descriotion", "h-2": "Type", "h-3": "Example", "0-0": "active_since\n*(optional)*", "0-1": "Filters results to devices that were active since a specific date.", "0-2": "YYYY-MM-DD", "0-3": "2013-12-25" }, "cols": 4, "rows": 1 } [/block] [block:api-header] { "type": "basic", "title": "Response" } [/block] Response contains the following structure: [block:parameters] { "data": { "0-0": "device_id", "h-0": "Field", "1-0": "details", "1-1": "The data of devices that match the query.", "0-1": "The device id.", "0-2": "String", "0-3": "e0fc05c3478926023a8607029f012f9f62bb4590", "h-3": "Example", "h-2": "Type", "h-1": "Description", "1-2": "See [Device Details](doc:device-details) Structure" }, "cols": 4, "rows": 2 } [/block]