Skip to content
Tenovi Docs

Measurement Data

It is highly recommended to make use of measurement webhooks for near real-time transmission from devices. GET requests described on this page should only be used for backfilling data or verifying data.

Retrieving Measurements

If data is either missed or improperly handled by the Measurement Webhook, or a client simply wants to validate the data in their system with the data stored by Tenovi, two Measurement endpoints are available to fetch measurement data on request.

The response data fields are identical to those sent in the Measurement Webhook POST requests.

Device Specific Measurement Data Queries

All measurements for a given HWI Device are returned. The hwi_device_id must be included in the URL.

/hwi/hwi-devices/{hwi_device_id}/measurements/

Details of this API endpoint can be found in our API Reference.

Patient Specific Measurement Data Queries

All measurements for a given Patient ID (optionally set during Device Activation) are returned. The patient_external_id must be included in the URL.

/hwi/patients/{patient_external_id}/measurements/

Details of this API endpoint can be found in our API Reference.

Optional Query Parameters

The optional query parameters allow the request to be filtered by metric__name (Examples include blood_pressure, temperature, perfusion_index, weight, pulse, glucose, spO2) or timestamp date greater than or equal to (timestamp__gte) or less than (timestamp__lt) a given timestamp in UTC.

  • metric__name: string
  • created__gte: ISO 8601 timestamp in UTC (i.e. YYYY–MM–DDTHH:MM:SSZ)
  • created__lt: ISO 8601 timestamp in UTC (i.e. YYYY–MM–DDTHH:MM:SSZ)
  • timestamp__gte: ISO 8601 timestamp in UTC (i.e. YYYY–MM–DDTHH:MM:SSZ)
  • timestamp__lt: ISO 8601 timestamp in UTC (i.e. YYYY–MM–DDTHH:MM:SSZ)

Measurement Response JSON Schema

[
    {
        "metric": "string",
        "device_name": "string",
        "hwi_device_id": "string",
        "patient_id": "string",
        "hardware_uuid": "string",
        "sensor_code": "string",
        "value_1": "string",
        "value_2": "string",
        "created": "2019-08-24T14:16:18Z",
        "timestamp": "2019-08-24T14:15:22Z",
        "timezone_offset": -2147483648,
        "estimated_timestamp": false,
        "filter_params": {}
    }
]