Backfilling Measurement Data

Tenovi delivers measurements in real time via webhooks. However, there are scenarios where you may need to retrieve measurements on demand:

• Your webhook endpoint was unreachable during a window of device activity
• You are seeding a new system with historical data
• You need to audit or verify that your records are complete

The HWI API provides two endpoints for pulling measurements directly.

• GET HWI Device Measurements
• GET HWI Patient Measurements

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

Endpoints

Endpoint	Use Case
GET /clients/{client_domain}/hwi/device-measurements/	Fetch measurements for a single device
GET /clients/{client_domain}/hwi/patient-measurements/	Fetch measurements for all devices assigned to a patient

Note

If a patient has multiple devices, GET Patient Measurements will return data across all of them in one response. Using GET Device Measurements requires a separate request per device.

Filtering by Date Range

To backfill a specific window, use the timestamp__gte and timestamp__lt query parameters.

GET /clients/{client_domain}/hwi/patient-measurements/?patient_id={id}& timestamp__gte={ISO8601}& timestamp__lt={ISO8601}

Example:

GET /clients/{client_domain}/hwi/patient-measurements/?patient_id=abc123&timestamp__gte=2024-01-01T00:00:00Z& timestamp__lt=2024-01-31T23:59:59Z

Note

Timestamps must be in ISO 8601 UTC format.

Pagination

Measurement endpoints support pagination. See the Pagination Guide for usage, response formats, and migration notes. On May 5, 2026 all measurement endpoints will either return paginated results if you supply page= or will be truncated.

Process

Using either a list of Patient IDs or a list of HWI Device IDs you can backfill or verify data by:

1. Getting a list of relevant IDs (Patient IDs or HWI Device IDs)
2. For each ID, make a GET request with the relevant date range. Use pagination to iterate through results (see Pagination Guide).
3. As each page of measurements is returned, check whether each record already exists in your system.
4. If a measurement isn’t saved in your system, you can then save it to get your system in-sync with Tenovi.

Testing with Postman

You can test both endpoints using the Tenovi Postman collection before implementing them in your system. The collection includes pre-configured requests for both GET Device Measurements and GET Patient Measurements.