v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_Daily and Custom Reports

Get device status reports within specified date-time range

⚠️ Legacy feature. Android only. Daily and Custom Reports are a legacy feature. For current reporting needs, use the Reports API: GET /report/v0/report-types, POST /report/v0/reports, and GET /report/v0/reports/{report_id}.

Returns per-device status reports organized by device group for a specified date-time range. This endpoint provides a hierarchical view of device health data grouped by Esper device groups, including active, inactive, registered, new, and disabled device counts, with per-device detail records nested inside each group.

About Get Device Report

The device report is a time-scoped snapshot of device status across your fleet, structured by group. Each group entry includes aggregate device counts and an array of DeviceStatusReport objects representing individual devices. Both start_date and end_date are required; only data within that window is returned.

get/enterprise/report/device-report/

Query parameters

start_datestring date-time required

Start date of range in which to retrieve device status reports

end_datestring date-time required

End date of range in which to retrieve device status reports

syncboolean

Sync device status report to specified field

fieldsstring

List of fields to add to device status report, comma separated

Response

successful operation

group_idstring uuid
group_namestring
group_pathstring
active_devicesinteger
inactive_devicesinteger
registered_devicesinteger
new_devicesinteger
disabled_devicesinteger