Skip to main content
POST
/
sensor-data
/
latest
Fetch latest sensor data
curl --request POST \
  --url https://api.beta.ontoto.com/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"
    }
  ]
}
'
{
  "items": [
    {
      "deviceSerialNumber": "<string>",
      "deviceAlias": "<string>",
      "legacyDeviceId": 0,
      "sensorUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sensorAlias": "<string>",
      "channelIndex": 123,
      "sensorStatus": "ok",
      "parameterUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parameterName": "<string>",
      "parameterAlias": "<string>",
      "parameterSourceType": "derived",
      "parameterStatus": "ok",
      "displayPrecision": 123,
      "unit": "<string>",
      "data": [
        {
          "timestamp": "2023-11-07T05:31:56Z",
          "value": 123
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.beta.ontoto.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-api-key
string
header
required

Body

application/json

Request body for querying latest sensor data

parameterUuids
string<uuid>[]

Array of parameter UUIDs

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
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

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
parameterPaths
object[]

Array of parameter paths to query specific data points

Response

Successful response

Response body for querying sensor data

items
object[]
required