This page lists all supported data types, units, and formats. For provider-specific availability, see the Provider Coverage Matrix .
Not all providers support all data types. Check the Provider Coverage Matrix to see which metrics are available from each wearable device. Timeseries Types The types parameter in the timeseries endpoint accepts the following values:
Heart & Cardiovascular Type Unit Description heart_ratebpm Heart rate resting_heart_ratebpm Resting heart rate heart_rate_variability_sdnnms HRV (SDNN method) heart_rate_variability_rmssdms HRV (RMSSD method) heart_rate_recovery_one_minutebpm HR recovery after 1 minute walking_heart_rate_averagebpm Average HR while walking recovery_scorescore Recovery score
Blood & Respiratory Type Unit Description oxygen_saturation% SpO2 blood oxygen blood_glucosemg/dL Blood glucose level blood_pressure_systolicmmHg Systolic blood pressure blood_pressure_diastolicmmHg Diastolic blood pressure respiratory_ratebrpm Breathing rate sleeping_breathing_disturbancescount Sleep breathing disturbances blood_alcohol_contentmg/dL Blood alcohol content peripheral_perfusion_indexscore Peripheral perfusion index forced_vital_capacityliters Forced vital capacity forced_expiratory_volume_1liters Forced expiratory volume (1s) peak_expiratory_flow_rateliters Peak expiratory flow rate
Body Composition Type Unit Description heightcm Height weightkg Weight body_fat_percentage% Body fat percentage body_mass_indexkg/m² BMI lean_body_masskg Lean body mass body_temperature°C Body temperature skin_temperature°C Skin temperature waist_circumferencecm Waist circumference body_fat_masskg Body fat mass skeletal_muscle_masskg Skeletal muscle mass
Fitness Metrics Type Unit Description vo2_maxmL/kg/min VO2 max six_minute_walk_test_distancemeters 6-minute walk test
Activity - Basic Type Unit Description stepscount Step count energykcal Active energy burned basal_energykcal Basal/resting energy stand_timeminutes Time spent standing exercise_timeminutes Exercise duration physical_effortscore Physical effort score flights_climbedcount Floors/flights climbed average_metMET Average metabolic equivalent
Activity - Distance Type Unit Description distance_walking_runningmeters Walking/running distance distance_cyclingmeters Cycling distance distance_swimmingmeters Swimming distance distance_downhill_snow_sportsmeters Skiing/snowboarding distance distance_othermeters Other distance
Activity - Walking Metrics Type Unit Description walking_step_lengthcm Average step length walking_speedm/s Walking speed walking_double_support_percentage% Double support time walking_asymmetry_percentage% Gait asymmetry walking_steadiness% Walking steadiness score stair_descent_speedm/s Stair descent speed stair_ascent_speedm/s Stair ascent speed
Activity - Running Metrics Type Unit Description running_powerwatts Running power running_speedm/s Running speed running_vertical_oscillationcm Vertical oscillation running_ground_contact_timems Ground contact time running_stride_lengthcm Stride length
Activity - Swimming Type Unit Description swimming_stroke_countcount Swimming strokes underwater_depthmeters Underwater depth
Activity - Generic Type Unit Description cadencerpm Cadence (cycling, etc.) powerwatts Power output speedm/s Speed workout_effort_scorescore Workout effort score estimated_workout_effort_scorescore Estimated workout effort score
Environmental Type Unit Description environmental_audio_exposuredB Environmental noise headphone_audio_exposuredB Headphone volume uv_exposurecount UV exposure inhaler_usagecount Inhaler usage weather_temperature°C Weather temperature weather_humidity% Weather humidity
Additional environmental types (environmental_sound_reduction, time_in_daylight, water_temperature) are defined but not currently supported by any provider.
Garmin-Specific Type Unit Description garmin_stress_levelscore Stress score (1-100) garmin_skin_temperature°C Skin temperature deviation from baseline garmin_fitness_ageyears Fitness age estimate garmin_body_battery% Body battery (0-100)
Other Type Unit Description electrodermal_activitycount Electrodermal activity push_countcount Push count (wheelchair) atrial_fibrillation_burdencount Atrial fibrillation burden insulin_deliverycount Insulin delivery number_of_times_fallencount Fall count number_of_alcoholic_beveragescount Alcoholic beverages nike_fuelcount Nike Fuel hydrationmL Hydration
Workout Types Common workout types returned by the events/workouts endpoint. This is not an exhaustive list - the API supports 80+ workout types:
Type Description runningRunning/jogging trail_runningTrail running treadmillTreadmill running cyclingCycling/biking mountain_bikingMountain biking indoor_cyclingIndoor/stationary cycling swimmingSwimming (generic) pool_swimmingPool swimming open_water_swimmingOpen water swimming walkingWalking hikingHiking mountaineeringMountaineering strength_trainingWeight/resistance training cardio_trainingCardio training yogaYoga pilatesPilates meditationMeditation ellipticalElliptical trainer rowingRowing cross_country_skiingCross-country skiing alpine_skiingAlpine skiing downhill_skiingDownhill skiing snowboardingSnowboarding soccerSoccer basketballBasketball tennisTennis golfGolf boxingBoxing martial_artsMartial arts rock_climbingRock climbing surfingSurfing kayakingKayaking triathlonTriathlon e_bikingE-biking danceDance otherOther/unknown activity
Workout types are normalized from provider-specific values. The original provider type is preserved in the raw data.
Resolution Options The resolution parameter for timeseries aggregation:
Resolution Description rawOriginal data points as recorded 1minAggregated to 1-minute intervals 5minAggregated to 5-minute intervals 15minAggregated to 15-minute intervals 1hourAggregated to 1-hour intervals
Example: Fetching Multiple Types curl -X GET "http://localhost:8000/api/v1/users/{user_id}/timeseries?start_time=2025-01-01T00:00:00Z&end_time=2025-01-31T00:00:00Z&types=heart_rate&types=steps&types=energy&resolution=1hour" \ -H "X-Open-Wearables-API-Key: YOUR_API_KEY"
Leave types empty to fetch all available data types for the user.
Provider Support Data availability varies by provider. Here’s a quick summary:
Provider Timeseries Workouts Sleep Best For Apple Health ✅ ✅ 🔜 Comprehensive health data Garmin ◐ ✅ 🔜 Fitness activities Polar ◐ ✅ ❌ Heart rate training Suunto ✅ ✅ ✅ Outdoor sports + 24/7 data Whoop ❌ ✅ ✅ Recovery, sleep & workouts
✅ Full support — Fully implemented
◐ Partial — Limited data (e.g., workouts only)
🔜 Coming soon — API supports, processing not yet implemented
❌ Not available — Not supported
Full Provider Coverage Matrix See detailed breakdown of which data types each provider supports, including provider-specific quirks and normalization details.
