Get historical device data

get

https://prod.lunalocate.com/api/v2/device/{device_id}/history

Query historical device data and metrics within a specified time range. Data is bucketed at regular intervals and includes network connectivity, location estimates, and sensor readings (temperature) for the device.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

device_id

string

required

The id of the device

Query Params

begin

date-time

Start time in RFC 3339 format (e.g., 2025-08-06T20:22:06Z). Optional if end and duration are provided.

end

date-time

End time in RFC 3339 format (e.g., 2025-08-07T20:22:06Z). Optional if begin and duration are provided.

duration

string

Duration as a string (e.g., 1h, 30m, 3600s). Optional if begin and end are provided. At least two of begin, end, and duration must be provided.

interval

string

Defaults to 1h

Interval for bucketing data as a string (e.g., 1h, 30m, 3600s). Minimum 60 seconds. Defaults to 1h.

order

string

enum

Sort order for results. Either 'period.asc' (oldest first) or 'period.desc' (newest first). Defaults to 'period.asc'.

Allowed:

select

string

Comma-delimited field selector to filter response fields (e.g., 'id,start_time,tracking'). Defaults to all fields.

Responses

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A list of historical data records, bucketed by the specified interval

400Invalid parameters (invalid time range, interval too small, etc.)

401Missing or invalid authorization token

404Device not found

500Internal server error