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/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/enterprise/{enterprise_id}/device/{device_id}/status/
  • Auth
    HTTP bearer

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

Changes

No recorded changes to this operation across all 6 revisions of this API.