POST api/Devices/{id}/Reading

Posts a new Reading for the input Device ID

Request Information

URI Parameters

Name	Description	Type	Additional information
id	ID of the Device to post a reading for	integer	Required

Body Parameters

Payload for the Device Log to create

ReadingPayload

Name	Description	Type	Additional information
Reading	Reading for the Log to create	string	None.
ReadingDate	Date for the Log to create	date	None.

Request Formats

application/json, text/json, text/html

Sample:

{
  "Reading": "sample string 1",
  "ReadingDate": "2026-01-09T23:47:53.0071376+10:00"
}

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'ReadingPayload'.

Response Information

Resource Description

Details on if the reading was successfully created and any relevant messages

GetDeviceLogResponse

Name	Description	Type	Additional information
Device	The device	ConnectedDeviceStruct	None.
DeviceLogs	Array of device log entries	Collection of ConnectedDeviceLog	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:

{
  "Device": {
    "PositionSourceName": "sample string 1",
    "PositionFromDataNode": true,
    "Position": {
      "Fix": true,
      "Age": 2,
      "Latitude": 1.0,
      "Longitude": 1.0,
      "Altitude": 1.0,
      "Course": 1.0,
      "Speed": 1.0,
      "Error": 1.0,
      "ReadingDate": "2026-01-09T23:47:53.0071376+10:00"
    },
    "NodeChannel": 1,
    "SerialNumber": "sample string 3",
    "Type": 1,
    "TypeName": "sample string 4",
    "SignalType": 0,
    "Controllable": true,
    "Schedulable": true,
    "Threshold": 1.0,
    "ReadingOverride": "sample string 5",
    "Specifications": "sample string 6",
    "PositionSourceID": 1,
    "Latitude": 1.0,
    "Longitude": 1.0,
    "Code": "sample string 7",
    "Allowance": 1,
    "DefaultValidationBeforeSpan": "00:00:00.1234567",
    "DefaultValidationBeforeLimit": 1,
    "DefaultValidationBeforeID": 1,
    "DefaultValidationBeforeEnable": true,
    "DefaultValidationBeforeName": "sample string 8",
    "DefaultValidationDuringSpan": "00:00:00.1234567",
    "DefaultValidationDuringLimit": 1,
    "DefaultValidationDuringID": 1,
    "DefaultValidationDuringEnable": true,
    "DefaultValidationDuringName": "sample string 9",
    "DefaultValidationAfterSpan": "00:00:00.1234567",
    "DefaultValidationAfterLimit": 1,
    "DefaultValidationAfterID": 1,
    "DefaultValidationAfterEnable": true,
    "DefaultValidationAfterName": "sample string 10",
    "DecimalPlaces": 1,
    "ReadingType": 1,
    "ReadingUnitType": 1,
    "Reading": {
      "DelayFromStart": 1,
      "TimeToRun": 2,
      "LastReading": "2026-01-09T23:47:53.0071376+10:00",
      "Type": 4,
      "Units": 5,
      "Value": "1.0",
      "NumericalValue": 1.0,
      "Notes": "sample string 6"
    },
    "ReadingMinValue": 1.0,
    "ReadingMaxValue": 1.0,
    "BandActionsEnabled": true,
    "ReadingValueBands": [
      {
        "ID": 1,
        "DisplayIndex": 2,
        "Description": "sample string 3",
        "BottomValue": 4.0,
        "TopValue": 5.0,
        "Color": "sample string 6",
        "AlertTriggerType": 0,
        "AlertType": 0,
        "AlertResendWaitTime": 7,
        "MaxAlertRepeat": 8,
        "OtherAlertTriggerValue": "sample string 9",
        "AutoAcknowledge": true,
        "NotifyAcknowledge": true,
        "ActionType": 0,
        "ActionTargetType": 10,
        "ActionTargetID": 12,
        "ActionValue": 13.0,
        "AlertCountRequired": 14
      },
      {
        "ID": 1,
        "DisplayIndex": 2,
        "Description": "sample string 3",
        "BottomValue": 4.0,
        "TopValue": 5.0,
        "Color": "sample string 6",
        "AlertTriggerType": 0,
        "AlertType": 0,
        "AlertResendWaitTime": 7,
        "MaxAlertRepeat": 8,
        "OtherAlertTriggerValue": "sample string 9",
        "AutoAcknowledge": true,
        "NotifyAcknowledge": true,
        "ActionType": 0,
        "ActionTargetType": 10,
        "ActionTargetID": 12,
        "ActionValue": 13.0,
        "AlertCountRequired": 14
      }
    ],
    "ID": 11,
    "Name": "sample string 12",
    "Description": "sample string 13",
    "DataNodeID": 1,
    "DataNodeName": "sample string 14",
    "Category": "sample string 15",
    "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": [
    {
      "DelayFromStart": 1,
      "TimeToRun": 2,
      "Value": "1.0",
      "NumericalValue": 1.0,
      "ReadingType": 4,
      "ReadingUnitType": 5,
      "ID": 6,
      "Date": "2026-01-09T23:47:53.0071376+10:00",
      "DeviceType": 10
    },
    {
      "DelayFromStart": 1,
      "TimeToRun": 2,
      "Value": "1.0",
      "NumericalValue": 1.0,
      "ReadingType": 4,
      "ReadingUnitType": 5,
      "ID": 6,
      "Date": "2026-01-09T23:47:53.0071376+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:47:53.0071376+10:00",
    "BuildDateUTC": "2026-01-09T23:47:53.0071376+10:00"
  },
  "VersionInformation": {
    "Major": 1,
    "Minor": 8,
    "Hotfix": 0,
    "Beta": true,
    "Version": "1.8.0.BETA"
  }
}