GET api/PositionDevices/Logs?id={id}&numberOfEntries={numberOfEntries}&startDate={startDate}&endDate={endDate}&includeNR={includeNR}

Returns reading logs for the specified Position Device, for the specified DateTimes. Note: Always expects a time value. i.e. if an end date of 2017-01-01 with no time is given, 00:00:00 of 2017-01-01 will be assumed and data from prior to this point in time will be returned. For a start date, the same assumption applies, and data after this point will be returned.

Request Information

URI Parameters

Name	Description	Type	Additional information
id	The integer ID of the PositionDevice to retrieve logs for	integer	Required
numberOfEntries	The number of entries to retrieve. If no value is provided, it will assume 10. If -1 is provided, it assumes all logs within the date period	integer	None.
startDate	The start date. If no value is provided, it will use the smallest possible value. For example, for the 1st of April 2020 at 1:30PM, use: 2020-04-01T13:30:00	date	None.
endDate	The end date. If no value is provided, it will use today's date. For example, for the 1st of April 2020 at 1:30PM, use: 2020-04-01T13:30:00	date	None.
includeNR	Whether or not to include NRs in the logs	boolean	None.

Body Parameters

None.

Response Information

Resource Description

Requested logs, if any, and any relevant messages

GetPositionDeviceLogResponse

Name	Description	Type	Additional information
PositionDevice	The device	PositionDeviceStruct	None.
DeviceLogs	Array of device log entries	Collection of PositionDeviceLog	None.
Messages	Array of messages	Collection of Message	None.
ServerInformation	Relevant information regarding the Server	ServerInformation	None.
VersionInformation	Relevant information regarding the API's version	VersionInformation	None.

Response Formats

application/json, text/json, text/html

Sample:

{
  "PositionDevice": {
    "NodeChannel": 1,
    "SerialNumber": "sample string 1",
    "Specifications": "sample string 2",
    "LatestPosition": {
      "Fix": true,
      "Age": 1,
      "Latitude": 2.0,
      "Longitude": 3.0,
      "Altitude": 1.0,
      "Course": 1.0,
      "Speed": 1.0,
      "Error": 1.0,
      "ID": 4,
      "Date": "2026-01-09T23:49:56.0717324+10:00",
      "DeviceType": 10
    },
    "ID": 3,
    "Name": "sample string 4",
    "Description": "sample string 5",
    "DataNodeID": 1,
    "DataNodeName": "sample string 6",
    "Category": "sample string 7",
    "Lifespan": 1,
    "ConfiguredAlerts": [
      {
        "ID": 1,
        "Enabled": true,
        "Name": "sample string 3",
        "Description": "sample string 4",
        "AlertType": 0,
        "MaxRepeats": 5,
        "WaitTime": 6,
        "OwnerID": 7,
        "OwnerType": 10,
        "Type": 0,
        "CheckInControlled": true
      },
      {
        "ID": 1,
        "Enabled": true,
        "Name": "sample string 3",
        "Description": "sample string 4",
        "AlertType": 0,
        "MaxRepeats": 5,
        "WaitTime": 6,
        "OwnerID": 7,
        "OwnerType": 10,
        "Type": 0,
        "CheckInControlled": true
      }
    ]
  },
  "DeviceLogs": [
    {
      "Fix": true,
      "Age": 1,
      "Latitude": 2.0,
      "Longitude": 3.0,
      "Altitude": 1.0,
      "Course": 1.0,
      "Speed": 1.0,
      "Error": 1.0,
      "ID": 4,
      "Date": "2026-01-09T23:49:56.0717324+10:00",
      "DeviceType": 10
    },
    {
      "Fix": true,
      "Age": 1,
      "Latitude": 2.0,
      "Longitude": 3.0,
      "Altitude": 1.0,
      "Course": 1.0,
      "Speed": 1.0,
      "Error": 1.0,
      "ID": 4,
      "Date": "2026-01-09T23:49:56.0717324+10:00",
      "DeviceType": 10
    }
  ],
  "Messages": [
    {
      "Severity": 0,
      "MessageCode": 1,
      "CodeDesc": 2,
      "MessageText": "sample string 3",
      "RecordNumber": 4
    },
    {
      "Severity": 0,
      "MessageCode": 1,
      "CodeDesc": 2,
      "MessageText": "sample string 3",
      "RecordNumber": 4
    }
  ],
  "ServerInformation": {
    "CurrentTimeUTC": "2026-01-09T23:49:56.0717324+10:00",
    "BuildDateUTC": "2026-01-09T23:49:56.0717324+10:00"
  },
  "VersionInformation": {
    "Major": 1,
    "Minor": 8,
    "Hotfix": 0,
    "Beta": true,
    "Version": "1.8.0.BETA"
  }
}