Skip to content

Get list of device locations
Stable

Request

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
Security
esper_cloud_api_apiKey
Path
enterprise_idstringrequired

A UUID string identifying this enterprise.

Query
limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v1/enterprise/{enterprise_id}/report/location/?limit=0&offset=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

successful operation

Bodyapplication/json
countintegerrequired
nextstring or null, (url)
previousstring or null, (url)
resultsArray of objects(esper_cloud_api_DeviceLocations)required
Response
{
  "count": 0,
  "next": "string",
  "previous": "string",
  "results": [
    { … }
  ]
}