Validic collects data from wearables, apps and in-home medical devices. This data is standardized into the various Metric types shown below. Metrics are grouped into Resources, such as “workouts” or “nutrition”, when presented via the API.

The supported list of metric types is listed below. While it is possible for any Metric Type to appear as part of any API Resource, the most common types of each API Resource are provided in the Resource section.

Working with Metrics

The Validic API supports a variety of metric types in an effort to succinctly present data recorded by a user. Each source (app, device, etc.) may have different representations of the same resource object and therefore, Validic does not define which metrics are presented as part of a provided resource object. Any supported metric may exist within any resource record for a user, in addition to any segment of a resource where provided. For example, a summary record and a workout record can both contain a metric type of steps. This allows the customer to receive a complete set of metrics for every record every time. When ingesting data off the Stream or RESTful APIs, the developer can iterate through the list of metrics verifying each type to determine whether or not the metric contains data relevant to their use case.

TypeCommonly FoundDefinitionData TypeUnitsStandard Unit
active_durationSummaries, WorkoutsTotal duration of active time as defined by the source.floats ms min hs
active_energy_burnedSummariesThe number of active calories burned as defined by the source.floatkcal kJ Jkcal
avg_cadenceWorkoutsThe average cadence as recorded by the source. Could represent revolutions per minute on a bike, strides per minute on a run, strokes per minute during a swim, and more.floatr/min SPMn/a
avg_heart_rateSummaries, Workouts, Measurements, IntradayThe average heart rate measured as determined by the source.integerbpmbpm
avg_paceWorkoutsThe average pace as recorded by the source.floatmin/kmn/a
avg_powerWorkoutsThe average power measurement.floatWW
avg_speedWorkoutsThe cumulative average speed measurement as determined by the source.floatm/s mi/s mph kphm/s
avg_spo2SummariesThe average blood oxygen saturation of the individual. Measured as defined by the source.floatpercentpercent
awake_countSleepThe number of instances the individual was awake during the designated sleep period as determined by the source.integercountcount
awake_durationSleepThe duration of time the user was awake during the sleep period as defined by the device.floats ms min hs
basal_energy_burnedSummariesThe number of bmr calories burned as defined by the source.floatkcal kJ Jkcal
blood_glucoseMeasurements, IntradayBlood glucose, or blood sugar, reading of the individual. May be an individual measurement or an average of multiple consecutive readings taken within a short period of time, as defined by the source.floatmg/dL mmol/Ln/a
blood_ketoneMeasurementsBlood ketone reading of the individual. May be an individual measurement or an average of multiple consecutive readings taken within a short period of time, as defined by the source.floatmg/dL mmol/Ln/a
bmiMeasurementsBody Mass Index. Calculated as weight in kg divided by height in m squaredfloatkg/m2kg/m2
body_armsMeasurementsBody arm circumference of the individual.floatcm incm
body_boneMeasurementsBody Bone Percentage. Calculated as bone mass divided by total body mass.floatpercentpercent
body_bone_massMeasurementsBody Bone Mass is the total amount of mass attributed to bone.floatg kg lb stkg
body_chestMeasurementsBody chest circumference of the individual.floatcm incm
body_fatMeasurementsBody Fat Percentage. Calculated as body fat mass divided by total body mass. Often estimated by devices.floatpercentpercent
body_fat_massMeasurementsBody Fat Mass is the total amount of mass attributed to fat.floatg kg lb stkg
body_heightMeasurementsBody height measurement of the individual.floatft m cmm
body_hipsMeasurementsBody hip circumference of the individual.floatcm incm
body_lean_massMeasurementsBody Lean Mass is the total amount of non fat mass.floatg kg lb stkg
body_muscleMeasurementsBody Muscle Percentage. Calculated as muscle mass divided by total body mass.floatpercentpercent
body_muscle_massMeasurementsBody Muscle Mass is the total amount of mass attributed to muscle.floatg kg lb stkg
body_temperatureMeasurementsThe body temperature measurement of the individual.floatC FC
body_thighsMeasurementsBody thigh circumference of the individual.floatcm incm
body_waistMeasurementsBody waist circumference of the individual.floatcm incm
body_waterMeasurementsBody Water Percentage. Calculated as water mass divided by total body mass.floatpercentpercent
body_water_massMeasurementsBody Water Mass is the total amount of mass attributed to water.floatg kg lb stkg
body_weightMeasurementsBody weight measurement of the individual.floatg kg lb stkg
calciumNutritionThe value of the measured quantity in milligrams.floatmgmg
carbohydrateNutritionThe value of measured quantity in grams.floatgg
cholesterolNutritionThe value of the measured quantity in milligrams.floatmgmg
deep_sleepSleepThe duration of time the individual was in a deep sleep state as defined by the source.floats ms min hs
diastolicMeasurementsThe diastolic blood pressure measurement of the individual.floatmmHg KPammHg
dietary_fiberNutritionThe value of the measured quantity in grams.floatgg
distanceSummaries, Workouts, IntradayThe distance traveled as defined by the source.floatm ft mi km ydm
elevationSummariesThe elevation changed as defined by the source.floatm ft mi km ydm
energy_burnedSummaries, WorkoutsTotal number of calories burned as defined by the source or calculated by Validic.floatkcal kJ Jkcal
energy_consumedNutritionThe total number of calories, or "energy," consumed.floatkcal kJ Jkcal
fairly_active_durationSummaries, WorkoutsTotal duration of fairly active time as defined by the source.floats ms min hs
fatNutritionThe value of measured quantity in gram.floatgg
fef_25_75MeasurementsForced expiratory flow (FEF) over the middle one half of the Forced Vital Capacity (FVC); the average flow from the point at which 25 percent of the FVC has been exhaled to the point at which 75 percent of the FVC has been exhaled.floatL/sL/s
fetMeasurementsForced Expiratory Time (FET) measures the length of the expiration.floatss
fev1MeasurementsFEV1 is the amount of air you can force from your lungs in one second.floatLL
fev1_per_fvcMeasurementsRepresents the proportion of a person's vital capacity that they are able to expire in the first second of forced expiration (FEV1) to the full, forced vital capacity (FVC). The result of this ratio is expressed as FEV1%.floatpercentpercent
fvcMeasurementsForced vital capacity (FVC) is the total amount of air exhaled during the FEV test.floatLL
floors_climbedSummaries, IntradayTotal number of floors climbed as defined by the source.integercountcount
glucose_ketone_indexMeasurementsGlucose Ketone Index (GKI) as provided by the source. Typically calculated as blood glucose in mmol/L divided by blood ketone in mmol/Lfloatmmol/Ln/a
heart_rate_variabilitySummaries, SleepThe heart rate variability of the individual during the period as determined by the source.floatmsms
heart_rate_zone_highSummaries, WorkoutsThe time spent in a high heart rate zone as determined by the source or Validic's algorithm.floatns ms s mins
heart_rate_zone_lowSummaries, WorkoutsThe time spent in a low heart rate zone as determined by the source or Validic's algorithm.floatns ms s mins
heart_rate_zone_mediumSummaries, WorkoutsThe time spent in a medium heart rate zone as determined by the source or Validic's algorithm.floatns ms s mins
heart_rate_zone_very_lowSummaries, WorkoutsThe time spent in a very low heart rate zone as determined by the source or Validic's algorithm.floatns ms s mins
high_stress_durationSummariesTotal duration of time that stress measurements were in a high stress range as defined by the source.floats, ms, min, hs
idle_hours_countSummariesThe count of hours in which the user didn’t stand up and move for at least one continuous minute during the hour.floatcountcount
in_bed_durationSleepThe duration of time the individual was in bed during the sleep period as defined by the sourcefloats ms min hs
inrMeasurementsThe international normalised ratio (INR) tells you how long it takes for your blood to clot.floatscalescale
insulinMeasurementsThe amount of insulin consumed by an individual.floatIUIU
lapsWorkoutsThe number of laps taken as defined by the source.integercountcount
light_sleepSleepThe duration of time the individual was in a light sleep state as defined by the source.floats ms min hs
lightly_active_durationSummaries, WorkoutsTotal duration of lightly active time as defined by the source.floats ms min hs
low_stress_durationSummariesTotal duration of time that stress measurements were in a low stress range as defined by the source.floats, ms, min, hs
max_cadenceWorkoutsThe maximum cadence as recorded by the source. Could represent revolutions per minute on a bike, strides per minute on a run, strokes per minute during a swim, and more.floatr/min, SPM, pushes/minn/a
max_heart_rateSummaries, Workouts, MeasurementsThe maximum heart rate measured as determined by the source.integerbpmbpm
max_paceWorkoutsThe maximum pace as recorded by the source.floatmin/kmn/a
max_speedWorkoutsThe highest discrete speed measurement.floatm/s mi/s mph kphm/s
max_spo2SummariesThe maximum blood oxygen saturation of the individual. Measured as defined by the source.floatpercentpercent
medium_stress_durationSummariesTotal duration of time that stress measurements were in a medium stress range as defined by the source.floats, ms, min, hs
min_heart_rateSummaries, Workouts, MeasurementsThe minimum heart rate measured as determined by the source.integerbpmbpm
min_spo2SummariesThe minimum blood oxygen saturation of the individual. Measured as defined by the source.floatpercentpercent
mindful_durationSummariesThe duration in which the user was in a meditative state.floats ms min hs
nap_durationSleepThe duration of time the individual was napping as defined by the source.floats, ms, min, hs
pefMeasurementsThe peak expiratory flow (PEF), also called peak expiratory flow rate (PEFR), is a person's maximum speed of expiration, as measured with a peak flow meter.floatL/sL/s
proteinNutritionThe value of measured quantity in grams.floatgg
pulseMeasurementsThe heart rate reading of the individual.integerbpmbpm
rem_sleepSleepThe duration of time the individual was in a REM sleep state as defined by the source.floats ms min hs
respiratory_rateSummariesThe average number of breaths per minute of the individual. Measured as defined by the source.floatb/mb/m
rest_stress_durationSummariesTotal duration of time that stress measurements were in a restful or recovery stress range as defined by the source.floats, ms, min, hs
resting_heart_rateSummariesThe waking heart rate measurement of the individual as determined by the source.integerbpmbpm
restless_countSleepThe number of times moved into a restless state as defined by the device during a sleep period.integercountcount
saturated_fatNutritionTotal saturated fat consumed.floatgg
sleep_durationSleepThe duration of time the user was sleeping during the sleep period as defined by the device.floats ms min hs
sleep_scoreSleepSleep efficiency as calculated by the source.floatpercentpercent
sodiumNutritionThe value of measured quantity in grams.floatg mgmg
spo2MeasurementsBlood oxygen saturation of the individual.floatpercentpercent
stand_hours_countSummariesThe count of hours in which the user stood up and moved for at least one continuous minute during the hour.floatcountcount
stepsSummaries, Workouts, IntradayThe number of steps taken in a single day as defined by the source. For sources that show only routine, non-workout steps as the daily step count, this value will match the steps shown by the source to the end user.integercountcount
sugarsNutritionThe amount of sugars that are either added during the processing of foods, or are packaged as such.floatgg
systolicMeasurementsThe systolic blood pressure measurement of the individual.floatmmHg KPammHg
time_to_fall_asleepSleepTime it took the individual to fall asleepfloats ms min hs
unsaturated_fatNutritionTotal unsaturated fat consumed.floatgg
very_active_durationSummaries, WorkoutsTotal duration of very active time as defined by the source.floats ms min hs
vo2_maxSummariesThe VO2 Max of the individual as determined by the source.floatmL/kg/minmL/kg/min
waterNutritionTotal amount of water consumed as defined by the source.floatmL fl ozmL
wheelchair_distanceSummariesThe wheelchair distance traveled as defined by the source.floatm, ft, mi, km, ydm
wheelchair_pushesSummariesThe number of wheelchair pushes recorded as defined by the source.integercountcount
workout_durationWorkoutsThe duration of the workout event as defined by the device or source.floats ms min hs