ESesper
esper_cloud_api_Device Telemetry

Get list of device locations

Lists reported location data for devices in an enterprise.

Returns a paginated list (count/next/previous/results) of DeviceLocations records, the same data source used to power the Console's device map/location dashboard view.

About Device Location Reports

This is part of Esper's Device Telemetry reporting, which surfaces device-reported data (like location) for fleet monitoring rather than issuing commands to devices.

Key Fields / Query Parameters

  • limit — number of results to return per page
  • offset — the initial index from which to return results

Common Use Cases

  • Powering a map view of where fleet devices are located
  • Auditing device location history for compliance or asset-tracking purposes
get/v1/enterprise/{enterprise_id}/report/location/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/v1/enterprise/{enterprise_id}/report/location/
  • Auth
    HTTP bearer

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

Query parameters

limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

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.