Skip to main content
POST
/
sensor-data
/
latest
Fetch latest sensor data
curl --request POST \
  --url https://api.beta.ontoto.com/v1/sensor-data/latest \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "parameterUuids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "deviceSerialNumbers": [
    "<string>"
  ],
  "legacyDeviceIds": [
    0
  ],
  "sensorUuids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "parameterPaths": [
    {
      "deviceSerialNumber": "1234567890",
      "sensorName": "VibratingWire_CH1",
      "parameterName": "Frequency_CH1"
    }
  ],
  "includeDeleted": true
}
'
{
  "items": [
    {
      "deviceSerialNumber": "<string>",
      "deviceAlias": "<string>",
      "legacyDeviceId": 0,
      "sensorUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sensorAlias": "<string>",
      "channelIndex": 123,
      "sensorStatus": "<string>",
      "parameterUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parameterName": "<string>",
      "parameterAlias": "<string>",
      "parameterSourceType": "<string>",
      "parameterStatus": "<string>",
      "displayPrecision": 123,
      "unit": "<string>",
      "data": [
        {
          "timestamp": "2023-11-07T05:31:56Z",
          "value": 123
        }
      ]
    }
  ]
}

Authorizations

x-api-key
string
header
required

Body

application/json

Request body for querying latest sensor data

parameterUuids
string<uuid>[]

Array of parameter UUIDs

deviceSerialNumbers
string[]

Array of device serial numbers

legacyDeviceIds
integer[]

Array of legacy device IDs

Required range: -9007199254740991 <= x <= 9007199254740991
sensorUuids
string<uuid>[]

Array of sensor UUIDs

parameterPaths
SensorParameterPath · object[]

Array of parameter paths to query specific data points

includeDeleted
boolean

Include soft-deleted sensor data in results

Response

Successful response

Response body for querying sensor data

items
ScalarSensorDataItem · object[]
required