v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_AndroidDevice

Get latest device event

Get the latest status event for an Android device. Retrieves the most recent DeviceStatus record for the specified Android device, containing a data payload with the device's current telemetry snapshot — including battery, connectivity, memory, storage, and other real-time device state information — along with the associated device and enterprise references and the event created_on timestamp. This endpoint is for Android devices only. For other platforms, use the following alternatives:

iOS, Linux, and Windows devices: GET /device/v0/devices/{id}/devicestate — returns current device state for non-Android platforms Android (v2): GET /v2/devices/{id}/ — returns a broader Android device record including current state fields in a more structured format

Note The latest_event query parameter must be set to 1 to return the most recent status event. Without this parameter the endpoint may return a paginated list of historical status records rather than the current snapshot. Common Use Cases Retrieving a real-time telemetry snapshot of an Android device's current state before issuing commands, checking battery level, connectivity, and storage availability as part of a pre-deployment health check, monitoring device state in custom dashboards or alerting Workflows, and diagnosing device issues by reviewing the most recent reported status.

Best Practices

Always include latest_event=1 when you need the current device state rather than historical events — omitting it may return a paginated history rather than the snapshot you expect. For broader device metadata including policy assignments, group membership, and hardware information, use GET /enterprise/{enterprise_id}/device/{device_id}/ instead. For a full history of device events over time, use GET /enterprise/{enterprise_id}/device/{device_id}/report/eventfeed/.

get/enterprise/{enterprise_id}/device/{device_id}/status/

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

device_idstring required

A UUID string identifying device.

Query parameters

latest_eventinteger required

Returns the latest event. Must be set to 1.

Response

successful operation

countinteger required
nextstring url nullable
previousstring url nullable