v1

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

Get group report

⚠️ 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 device count summaries broken down by device group for a specified date-time range. Use this endpoint to get group-level device status aggregates — active, inactive, registered, new, and disabled counts — without per-device detail records.

About Get Group Report

The group report provides a fleet view organized by Esper device groups, returning one GroupReport object per group within the specified date window. It is a leaner alternative to the device report when group-level aggregates are all that's needed. Both start_date and end_date are required.

get/enterprise/report/group-report/

Query parameters

start_datestring date-time required

Start date of range in which to retrieve group report.

end_datestring date-time required

End date of range in which to retrieve group report.

syncboolean

Sync device status report to specified field

Response

successful operation

group_idstring uuid
group_namestring
group_pathstring
active_devicesinteger
inactive_devicesinteger
registered_devicesinteger
new_devicesinteger
disabled_devicesinteger