Get enterprise report

Get enterprise report
Stable

Request

⚠️ 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 a high-level summary of device provisioning and activity across the entire enterprise for a specified date-time range. Use this endpoint to retrieve top-level fleet metrics — peak active devices, total provisioned devices, and total registered devices — for a given reporting window, without group or per-device breakdowns.

About Get Enterprise Report

The enterprise report provides a single aggregated view of fleet scale and activity for a time window bounded by start_date and end_date. Unlike the device report (per-device data by group) or the group report (segmented by group), this endpoint collapses the entire fleet into three summary metrics. It is most useful for executive dashboards, capacity planning, and trend tracking in legacy reporting contexts.

Security

esper_cloud_api_apiKey

Query

start_datestring, (date-time)required

Start date of range in which to retrieve enterprise report.

end_datestring, (date-time)required

End date of range in which to retrieve enterprise report.

cURL

curl -i -X GET \
  'https://api.esper.io/_mock/openapi/enterprise/report/enterprise-report/?start_date=2019-08-24T14%3A15%3A22Z&end_date=2019-08-24T14%3A15%3A22Z' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json

peak_active_devicesinteger

provisioned_devicesinteger

registered_devicesinteger

Response

{
  "peak_active_devices": 0,
  "provisioned_devices": 0,
  "registered_devices": 0
}