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.

Note

As of April 2026, these endpoints support pagination via ?page= and?page_size= parameters. See the Pagination Guide for usage and migration notes. Pagination will be the default behaviour on May 5, 2026.

Device Specific Measurement Data Queries

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

GET /clients/{client_domain}/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.

GET /clients/{client_domain}/hwi/patients/{patient_external_id}/measurements/

Note

Uniqueness is not enforced for this field. All measurements from all devices associated with a patient with the given External ID will be returned.

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)

Note

Each query parameter includes a double-underscore. This must be included for the filter to function properly. An example URL with a query parameter is:

GET /clients/{client_domain}/hwi/patients/12345/measurements/?metric__name=glucose

Caution

As of May 5, 2026, requests with no time range specified will default to the last 30 days of data. Requests spanning more than 30 days without pagination will be truncated at 1,000 results.

Use timestamp__gte and timestamp__lt to control the window, or adopt pagination to retrieve full result sets. See the Pagination Guide for usage and migration notes

Example Response JSON Schema

Non-Paginated Response

[
    {
        "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": {}
    }
]

Paginated Response

{
    "count": 255,
    "next": "https://api.tenovi.com/clients/{client_domain}/hwi/patients/{id}/measurements/?page=2&page_size=100",
    "previous": null,
    "results": [
        {
            "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": {}
        },
        …
    ]
}