Retrieve live data from one or more devices

This endpoint allows the retrieval of live data from devices identified by their device ID. Device authentication is required. Upon receiving the request, the API triggers the retrieval of live data from the device through a background task. The live data is collected and stored in a container associated with the device session. The API returns the live data response, containing telemetry information and other relevant device data. A single device ID returns the device's live data object directly under 'livedata'. Multiple comma-separated device IDs return a map under 'livedata' keyed by device ID, where each value is the device's live data or null if the device did not respond within the timeout; the request is pushed to all devices in parallel with a single shared 30-second timeout window, and devices the user is not authorized for are excluded from the response. The API has a rate limit of 1 API call for each user and device every 1 minute; a multi-device request is rejected as a whole if any of its devices is rate limited.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The ID of the device to retrieve live data from, or a comma-separated list of device IDs (e.g. 'device1,device2') for a multi-device request

Query Params
string

A comma-separated list of categories of data to return from the remote device. Options include 'apps' (information about installed applications), 'diskstats' (storage data), 'system_properties' (system properties), 'settings' (Android settings), 'filesystem' (data about device volumes), and 'capabilities' (device capabilities: supported resolutions, supported sound formats, and installed apps with their available actions).

Responses

400

Bad Request

401

Unauthorized

403

Forbidden

429

Too Many Requests

503

Service Unavailable

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json