Skip to main content

History

Retrieve an Object's History​

GEThttps://api.hivekit.io/v2/realm/[realmId]/history/[objectId]?start=time&end=time

Retrieves the history of an object in a given time range. The time range is specified by the start and end query parameters. The time range is inclusive, i.e. the object's state at start and end is included in the result.

You can specify the time range in two ways:

  • As RFC3339Nano, e.g. 2024-02-01T13:07:08.219Z
  • As Unix timestamp in milliseconds, e.g. 1706792948350

Response Body​

[
   {
      "data": {
         "charge": 0.2
      },
      "location": {
         "accuracy": 0,
         "altitude": 0,
         "altitudeAccuracy": 0,
         "heading": 0,
         "latitude": 12.34,
         "longitude": 56.78,
         "speed": 0,
         "time": "2024-02-01T13:12:03.5544812Z"
      },
      "time": "2024-02-01T13:12:03.554481Z"
   },
   {
      "data": {
         "charge": 0.3
      },
      "location": {
         "accuracy": 0,
         "altitude": 0,
         "altitudeAccuracy": 0,
         "heading": 0,
         "latitude": 13.34,
         "longitude": 58.78,
         "speed": 0,
         "time": "2024-02-01T13:12:04.0720622Z"
      },
      "time": "2024-02-01T13:12:04.072062Z"
   },
   {
      "data": {
         "charge": 0.5
      },
      "location": {
         "accuracy": 0,
         "altitude": 0,
         "altitudeAccuracy": 0,
         "heading": 0,
         "latitude": 14.34,
         "longitude": 51.78,
         "speed": 0,
         "time": "2024-02-01T13:12:04.5861172Z"
      },
      "time": "2024-02-01T13:12:04.586117Z"
   }
]