Skip to content

Summary of devices

GET
/users/id/getDeviceSummary

Lists all devices for a user, with a summary of state, including most resent points.

Parameters

Path Parameters

id*

user id

Typestring
Required
formatJSON

Query Parameters

pointCount

Maximum number of points to return per device. Default 5.

Typestring
formatJSON
dateRange

What date range to consider when retrieving recent points. Typical use is [TimeOfLastPointDownload, NOW]. Defaults to all time.

Typestring
formatJSON
hideApprox

Don't include GSM / poor accuracy locations. Default to false.

Typestring
formatJSON

Responses

Request was successful
application/json
JSON
[
{
}
]

Samples

cURL
curl -X GET \
'https://api.lightbug.cloud/api/users/id/getDeviceSummary' \
 -H "Content-Type: application/json"
JavaScript
fetch('https://api.lightbug.cloud/api/users/id/getDeviceSummary', {headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));
PHP
<?php
$url = 'https://api.lightbug.cloud/api/users/id/getDeviceSummary';
$method = 'GET';
$headers = [
    'Content-Type' => 'application/json',
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
Python
import requests

url = 'https://api.lightbug.cloud/api/users/id/getDeviceSummary'

headers = {
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)
print(response.json())