GET api/v1/devices/{deviceId}/location?sortOrder={sortOrder}&startDate={startDate}&endDate={endDate}

Get the devices location history.

Request Information

URI Parameters

Name	Description	Type	Additional information
deviceId		globally unique identifier	Required
sortOrder		SortOrder	Default value is Asc
startDate		string	None.
endDate	Leave empty for all locations upto the current time.	string	None.

Body Parameters

None.

Response Information

Resource Description

DeviceLocationHistoryDto

Name	Description	Type	Additional information
History		Collection of LocationHistoryDto	None.
Summary		LocationHistorySummary	None.

Response Formats

application/json, text/json, application/senml+json

Sample:

{
  "History": [
    {
      "Id": "fd6345e3-870e-4e19-8d61-407fcf28a5ee",
      "Name": "sample string 2",
      "Latitude": 3.1,
      "Longitude": 4.1,
      "Elevation": 5.1,
      "WellKnownLocationId": "1e58d602-2053-41c3-8632-d3f5ceb21bc7",
      "Date": "2026-08-15T03:19:53.2232149+00:00",
      "TimeAtLocationSeconds": 1,
      "DistanceTraveledMeters": 6.1
    },
    {
      "Id": "fd6345e3-870e-4e19-8d61-407fcf28a5ee",
      "Name": "sample string 2",
      "Latitude": 3.1,
      "Longitude": 4.1,
      "Elevation": 5.1,
      "WellKnownLocationId": "1e58d602-2053-41c3-8632-d3f5ceb21bc7",
      "Date": "2026-08-15T03:19:53.2232149+00:00",
      "TimeAtLocationSeconds": 1,
      "DistanceTraveledMeters": 6.1
    }
  ],
  "Summary": {
    "TotalTimeSeconds": 1,
    "TotalDistanceMeters": 2.1
  }
}

application/xml, text/xml

Sample:

<DeviceLocationHistoryDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.DeviceLocation">
  <History>
    <LocationHistoryDto>
      <Date>2026-08-15T03:19:53.2232149+00:00</Date>
      <DistanceTraveledMeters>6.1</DistanceTraveledMeters>
      <Elevation>5.1</Elevation>
      <Id>fd6345e3-870e-4e19-8d61-407fcf28a5ee</Id>
      <Latitude>3.1</Latitude>
      <Longitude>4.1</Longitude>
      <Name>sample string 2</Name>
      <TimeAtLocationSeconds>1</TimeAtLocationSeconds>
      <WellKnownLocationId>1e58d602-2053-41c3-8632-d3f5ceb21bc7</WellKnownLocationId>
    </LocationHistoryDto>
    <LocationHistoryDto>
      <Date>2026-08-15T03:19:53.2232149+00:00</Date>
      <DistanceTraveledMeters>6.1</DistanceTraveledMeters>
      <Elevation>5.1</Elevation>
      <Id>fd6345e3-870e-4e19-8d61-407fcf28a5ee</Id>
      <Latitude>3.1</Latitude>
      <Longitude>4.1</Longitude>
      <Name>sample string 2</Name>
      <TimeAtLocationSeconds>1</TimeAtLocationSeconds>
      <WellKnownLocationId>1e58d602-2053-41c3-8632-d3f5ceb21bc7</WellKnownLocationId>
    </LocationHistoryDto>
  </History>
  <Summary>
    <TotalDistanceMeters>2.1</TotalDistanceMeters>
    <TotalTimeSeconds>1</TotalTimeSeconds>
  </Summary>
</DeviceLocationHistoryDto>