Tenovi Hardware Device Overview

This page describes a high-level overview of our Hardware Integration (HWI) Devices. Please also refer to our high-level API Documentation, our Frequently Asked Questions, and our more detailed Redoc Documentation for additional information.

Data Transfer: Via Tenovi Gateway, whenever a reading is taken

Sensor Code: 10

On-Device Measurement Storage: Yes – measurements taken outside of range of the Tenovi Gateway will be saved locally and uploaded the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Other Notes: Multiple cuff sizes available; selected via Device Name (e.g. “Tenovi BPM – L” or “Tenovi BPM – S”)

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood Pressureblood_pressureSystolic BP (mmHG)Diastolic BPM (mmHG)YES
Heart RatepulsePulse (beats/minute)N/AYES
Irregular Heartbeatirregular_heartbeat1 (measurement is only sent if an irregular heartbeat is detected)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
measurement_indexAny Positive IntegerAn index value that can be used to identify if a Blood Pressure and Pulse measurement with the same timestamp were captured in the same physical reading. Not globally unique across all physical readings.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken

Sensor Code: 11

On-Device Measurement Storage: No – measurements taken outside of range of the Tenovi Gateway will NOT be saved locally.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood OxygenspO2Oxygen Saturation (%)Standard Deviation (N/A)YES
Heart RatepulsePulse (beats/minute)Standard Deviation (N/A)YES
Perfusion Indexperfusion_indexPerfusion Index (%)Standard Deviation (N/A)YES

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
measurement_indexAny Positive IntegerAn index value that can be used to identify if a Blood Oxygen, Pulse, and Perfusion Index measurement with the same timestamp were captured in the same physical reading. Not globally unique across all physical readings.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken.

Sensor Code: 12

On-Device Measurement Storage: Yes – measurements taken outside of range of the Tenovi Gateway will be saved locally and uploaded the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood GlucoseglucoseGlucose Level (in mg/dL)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
alert“sensor_result_above_range”An alert flag that is only included if an out-of-range reading is detected.
meal_context“pre-prandial”, “post-prandial”, “fasting”Contextual data entered by the end user to indicate if the reading was taken before a meal, after a meal, or while fasting.
measurement_location“finger”, 
“alternative site”,
“earlobe”,
“control solution”,
“N/A”
Contextual data entered by the end user to indicate where the blood sample used for this measurement was collected from.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken.

Sensor Code: 13

On-Device Measurement Storage: No – measurements taken outside of range of the Tenovi Gateway will NOT be saved locally.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
WeightweightWeight (in US pounds)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params: N/A

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken.

Sensor Code: 14

On-Device Measurement Storage: No– measurements taken outside of range of the Tenovi Gateway will NOT be saved locally.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
TemperaturetemperatureTemperature (in °F)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params: N/A

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, once per day.

Sensor Code: 15

On-Device Measurement Storage: Yes – data is stored locally on the Tenovi Watch and uploaded once per day when the Tenovi Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Steps**stepsHourly Steps (steps)N/ANO
Heart Rate Statisticsheart_rate_statisticsAverage Pulse (bpm)Maximum Pulse (bpm)NO
SleepsleepHours of Sleep (hours)N/ANO
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

**Steps and Heart Rate Statistics are logged in hourly bins. The measurement timestamp will indicate the start of the relevant logging period (i.e. the 9:00am measurement indicates the total steps taken between 9am and 10am).

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
average_heart_rate*Positive IntegerThe average heart rate (in bpm) during the relevant hour (equivalent to Value 1)
max_heart_rate*Positive IntegerThe maximum heart rate (in bpm) during the relevant hour (equivalent to Value 2)
min_heart_rate*Positive IntegerThe minimum heart rate (in bpm) during the relevant hour 

*These key-value pairs are only included in Heart Rate Statistics measurements.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
step_goalPositive IntegerThe daily step goal that will be indicated to users on their watch screen.
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken.

Sensor Code: 17

On-Device Measurement Storage: No– measurements taken outside of range of the Tenovi Gateway will NOT be saved locally.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
PEFpeak_expiratory_flowPEF (in L/min)N/AYES
FEVforced_expiratory_volumeFEV (in L)N/AYES

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
measurement_indexAny Positive IntegerAn index value that can be used to identify if a PEF and FEV measurement with the same timestamp were captured in the same physical reading. Not globally unique across all physical readings.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a compartment is opened or a refill event occurs.

Sensor Code: 21

On-Device Measurement Storage: YES – events recorded outside of range of the Tenovi Gateway will be saved locally and transmitted the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Open Eventpillbox_opened

Day of Compartment

(1=Sun, 7=Sat)

AM vs PM Compartment 

(1=AM, 2=PM)

YES**
Refill Initiatedpillbox_refill_initiated1 (N/A)0 (N/A)YES**
Compartement Refilledpillbox_refilled

Day of Compartment

(1=Sun, 7=Sat)

AM vs PM Compartment 

(1=AM, 2=PM)

YES**
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

**The Tenovi Pillbox monitors medication adherence, which can be used for RTM billing only.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
compartment

“Sunday AM”, “Sunday PM”,

“Monday AM”, etc.

A human-readable indication of the compartment opened (only included in Open Events)

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Direct Cellular Connection, whenever a reading is taken

Sensor Code: N/A

On-Device Measurement Storage: Yes – measurements taken outside of range of a cellular network will be saved locally and uploaded the next time a cellular connection is established.

Supports tracking multiple devices per gateway via Sensor IDs: N/A

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood Pressureblood_pressureSystolic BP (mmHG)Diastolic BPM (mmHG)YES
Heart RatepulsePulse (beats/min)N/AYES
Irregular
Heartbeat Event
irregular_heartbeat1 (N/A)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params: N/A

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Direct Cellular Connection, whenever a reading is taken

Sensor Code: N/A

On-Device Measurement Storage: Yes – measurements taken outside of range of a cellular network will be saved locally and uploaded the next time a cellular connection is established.

Supports tracking multiple devices per gateway via Sensor IDs: N/A

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood GlucoseglucoseGlucose Level (mg/dL)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params: N/A

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Direct Cellular Connection, whenever a reading is taken

Sensor Code: N/A

On-Device Measurement Storage: Yes – measurements taken outside of range of a cellular network will be saved locally and uploaded the next time a cellular connection is established.

Supports tracking multiple devices per gateway via Sensor IDs: N/A

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
WeightweightWeight (US pounds)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params: N/A

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Direct Cellular Connection, whenever a reading is taken

Sensor Code: N/A

On-Device Measurement Storage: No – measurements taken outside of range of a Cellular network will NOT be saved locally.

Supports tracking multiple devices per gateway via Sensor IDs: N/A

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood OxygenspO2Oxygen Saturation (%)Standard Deviation (N/A)YES
Heart RatepulsePulse (beats/minute)Standard Deviation (N/A)YES
Perfusion Indexperfusion_indexPerfusion Index (%)Standard Deviation (N/A)YES

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter ParamsN/A

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken

Sensor Code: 10

On-Device Measurement Storage: Yes – measurements taken outside of range of the Tenovi Gateway will be saved locally and uploaded the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood Pressureblood_pressureSystolic BP (mmHG)Diastolic BPM (mmHG)YES
Heart RatepulsePulse (beats/minute)N/AYES
Irregular Heartbeatirregular_heartbeat1 (measurement is only sent if an irregular heartbeat is detected)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
measurement_indexAny Positive IntegerAn index value that can be used to identify if a Blood Pressure and Pulse measurement with the same timestamp were captured in the same physical reading. Not globally unique across all physical readings.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken.

Sensor Code: 13

On-Device Measurement Storage: Yes – measurements taken outside of range of the Tenovi Gateway will be saved locally and uploaded the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
WeightweightWeight (in US pounds)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params: N/A

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken

Sensor Code: 24

On-Device Measurement Storage: Yes – measurements taken outside of range of the Tenovi Gateway will be saved locally and uploaded the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood OxygenspO2Oxygen Saturation (%)N/AYES
Heart RatepulsePulse (beats/minute)N/AYES
Perfusion Indexperfusion_indexPerfusion Index (%)N/AYES
Battery Levelbattery_percentageBattery Life  (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
measurement_indexAny Positive IntegerAn index value that can be used to identify if a Blood Oxygen, Pulse, and Perfusion Index measurement with the same timestamp were captured in the same physical reading. Not globally unique across all physical readings.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken.

Sensor Code: 12

On-Device Measurement Storage: Yes – measurements taken outside of range of the Tenovi Gateway will be saved locally and uploaded the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDs: No – only one device with this Sensor Code can be assigned to a gateway at one time.

Other Notes: This device must be bonded to the Tenovi Gateway. To do this, you must set the Bluetooth Passkey property, either via API (see below), or via the Client Devices dashboard on app.tenovi.com.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood GlucoseglucoseGlucose Level (in mg/dL)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
alert“sensor_result_above_range”An alert flag that is only included if an out-of-range reading is detected.
meal_context“pre-prandial”, “post-prandial”, “fasting”Contextual data entered by the end user to indicate if the reading was taken before a meal, after a meal, or while fasting.
measurement_location“finger”, 
“alternative site”,
“earlobe”,
“control solution”,
“N/A”
Contextual data entered by the end user to indicate where the blood sample used for this measurement was collected from.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
bluetooth_passkeyNumerical Bluetooth PasskeySet this property to allow the Gateway to automatically bond to a specific Trividia Glucometer. For these devices, the Bluetooth Passkey is the last 6 digits of the Serial Number printed on the label.
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken

Sensor Code: 10

On-Device Measurement Storage: Yes – measurements taken outside of range of the Tenovi Gateway will be saved locally and uploaded the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsNo – only one device with this Sensor Code can be assigned to a gateway at one time.

Metrics:

NameAPI FormatValue 1 (Units)Value 2 (Units)Is Vital?*
Blood Pressureblood_pressureSystolic BP (mmHG)Diastolic BPM (mmHG)YES
Heart RatepulsePulse (beats/minute)N/AYES
Battery Levelbattery_percentageBattery Life (%)N/ANO

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

KeyPossible ValuesDescription
measurement_indexAny Positive IntegerAn index value that can be used to identify if a Blood Pressure and Pulse measurement with the same timestamp were captured in the same physical reading. Not globally unique across all physical readings.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).

Data Transfer: Via Tenovi Gateway, whenever a reading is taken

Sensor Code: 25

On-Device Measurement Storage: Yes – measurements taken outside of range of the Tenovi Gateway will be saved locally and uploaded the next time the Gateway is in range.

Supports tracking multiple devices per gateway via Sensor IDsYes (required) – the Hailie Sensor’s Serial No must be included as the “sensor_id” when activating new devices. Measurements will be linked to the Client Devices with the Serial No of the physical device used.

Metrics:

Name

API Format

Value 1 (Units)

Value 2 (Units)

Is Vital?*

Hailie Medication Event

hailie_medication_event


1

N/A

Yes

Low Battery Event

low_battery_event

1 or 0 (critical/low)

N/A

No

Hailie Turbohaler Rotation Event

hailie_turbohaler_rotation_event

1 or 0 (click/non-click)

N/A

No

Hailie Respiratory Flow Log

hailie_respiratory_flow_log

Max Flow Rate (L/M)

Avg Flow Rate (L/M)

Yes

Hailie Respiratory Timing Log

hailie_respiratory_timing_log


Duration (s)

Time to Peak (s)

Yes

Hailie Shake Detection Event

hailie_shake_detection_event

1 or 0 (valid shake or not)

Shake Duration (s)

No

Hailie Inhaler Installed Event

hailie_inhaler_installed_event

1 or 0 (installed or removed)

N/A

No

Hailie Medication Cap Event

hailie_medication_cap_event

1 or 0 (cap on/cap off)

N/A

No

*Non-Vital Metrics are not counted towards the # of days with data in our billing reports.

Additional Data Included in Filter Params:

Key

Possible Values

Description

angle

NA

0 to 22.5

22.5 to 45

45 to 67.5

67.5 to 90

90 to 112.5

112.5 to 135

135 to 157.5

157.5 to 180

The angle the device was in when the medication log was stored

flags

key-value pairs

Variable vendor-defined flags (depending on metric type):

hailie_respiratory_flow_log:

  • inhalation_valid: 0/1
  • flow_error: 0/1
  • exhalation_detected: 0/1

hailie_shake_detection_event:

  • shake_intensity: positive integer

hailie_medication_event or halie_turbohaler_rotation_event:

  • respiration_enabled: 0/1
  • orientation_enabled: 0/1
  • orientation_stored: 0/1
  • orientation_valid: 0/1 

serial_number

6 to 8 alphanumeric characters

Serial number of the sensor associated with the event

device_log_index

Any Positive Integer

An index value provided by the Hailie Sensor that can be used to identify if a reading is unique or a duplicate of a previous reading.

Additional Parameters That Can be Set Via Device Properties:

KeyPossible ValuesDescription
measurement_webhook_idWebhook UUIDSet this property to configure a Device to only send measurement data to a single Webhook (specified by that Webhook’s ID).