Skip to content

Get location of specific device
Stable

Request

Retrieves a single reported device location record by ID.

Returns the DeviceLocations detail for the given location_id, useful when you already have a specific location record's identifier (for example, from the list endpoint) and want its full detail.

About Device Location Reports

This is part of Esper's Device Telemetry reporting, which surfaces device-reported data such as location for fleet monitoring. The location_id here identifies a specific reported location record, not the device itself.

Key Fields / Query Parameters

  • location_id — integer ID of the specific location record to retrieve

Common Use Cases

  • Fetching the detail behind a single location entry surfaced in a location list or map view
Security
esper_cloud_api_apiKey
Path
enterprise_idstringrequired

A UUID string identifying this enterprise.

location_idintegerrequired

An integer identifying the location.

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

Responses

successful operation

Bodyapplication/json
idinteger
latitudenumber, (double)
longitudenumber, (double)
altitudenumber, (double)
citystring
statusstring
countrystring
zipcodeinteger
last_updated_onstring, (date-time)
devicestring, (url)
enterprisestring, (url)
Response
{
  "id": 0,
  "latitude": 0.1,
  "longitude": 0.1,
  "altitude": 0.1,
  "city": "string",
  "status": "string",
  "country": "string",
  "zipcode": 0,
  "last_updated_on": "2019-08-24T14:15:22Z",
  "device": "string",
  "enterprise": "string"
}