v1
latestOpenAPI 3.1.02026-07-136587849.3 KBQueries / Workouts
List Workouts
This endpoint returns a list of workouts for a user, including various types of physical activities and exercises. Workouts represent structured physical activities that can be tracked and analyzed for fitness and health purposes.
Workout Types
Workouts encompass a wide variety of physical activities. For a complete list of available workout types, see the Activity Types documentation.
Workout Structure
Each workout contains:
- Base Information: Start time, end time, duration, and provider details
- Activity Details: Workout type, name, tags, and unique identifier
- Metrics: Distance, calories, heart rate, pace, and other relevant measurements
- Optional Components: Sessions, laps, samples, route points, splits, and segments
Data Inclusion Options
The endpoint supports various inclusion parameters to customize the response:
- Sessions: Include workout session breakdowns
- Laps: Include lap-by-lap data for structured activities
- Samples: Include detailed time-series data points
- Route Points: Include GPS coordinates and route information
- Splits: Include split times for timed activities
- Segments: Include segment breakdowns for complex workouts
Activity Tags
Workouts are categorized using activity tags that help classify the type of activity. For a complete list of available activity tags, see the Activity Types documentation.
All timestamps in both request and response are in the UTC timezone.
get/queries/workouts
Query parameters
from_timestampstring date-time
Start time of the query range in UTC, inclusive
Example:2006-01-02T15:04:05
Start time of the query range in UTC, inclusive
to_timestampstring date-time
End time of the query range in UTC, non-inclusive
Example:2006-01-02T15:04:05
End time of the query range in UTC, non-inclusive
providersstring[] nullable
Providers
Providers
[ "strava" ]
activity_tagsstring[] nullable
Activity tags
Activity tags
activity_typesstring[] nullable
Activity types
Activity types
include_sessionsboolean
Include sessions
Include sessions
include_lapsboolean
Include laps
Include laps
include_samplesboolean
Include samples
Include samples
include_route_pointsboolean
Include route points
Include route points
include_splitsboolean
Include splits
Include splits
include_segmentsboolean
Include segments
Include segments
Response
OK
Example response
{
"from_timestamp": "2006-01-02T00:00:00Z",
"to_timestamp": "2006-01-02T00:00:00Z",
"workouts": [
{
"laps": [
{
"metrics": {
"air_temperature": 22.73,
"air_temperature_max": 28.55,
"air_temperature_min": 15.27,
"ascent": 320.29,
"basal_body_temperature": 36.53,
"basal_body_temperature_max": 37.03,
"basal_body_temperature_min": 36.01,
"bedtime_duration": 28800000,
"blood_pressure_diastolic": 80.03,
"blood_pressure_diastolic_max": 90.07,
"blood_pressure_diastolic_min": 60.01,
"blood_pressure_systolic": 120.03,
"blood_pressure_systolic_max": 140.07,
"blood_pressure_systolic_min": 100.01,
"body_bone_mass": 3200,
"body_fat": 18.53,
"body_fat_max": 25.03,
"body_fat_min": 12.01,
"body_mass_index": 22.5016,
"body_temperature": 36.73,
"body_temperature_max": 37.55,
"body_temperature_min": 36.13,
"breathing_rate": 16.5016,
"breathing_rate_max": 24.7549,
"breathing_rate_min": 12.2534,
"cadence": 85.5016,
"cadence_max": 110.0049,
"cadence_min": 60.0034,
"calories_burned": 1650.7549,
"calories_burned_active": 450.2516,
"calories_burned_basal": 1200.5034,
"calories_intake": 2100.5016,
"descent": 280.91,
"distance": 6500.2516,
"distance_cycling": 15000.7549,
"distance_running": 5000.5016,
"distance_swimming": 1000.7549,
"distance_walking": 3200.5034,
"distance_wheelchair": 2800.5034,
"duration_active": 5400000,
"duration_high_intensity": 1200000,
"duration_low_intensity": 9000000,
"duration_moderate_intensity": 2400000,
"ecg_rri": 850,
"ecg_voltage": 1200.53,
"elevation": 1050.73,
"elevation_gain": 450.83,
"elevation_loss": 380.47,
"elevation_max": 1250.55,
"elevation_min": 850.37,
"floors_climbed": 12,
"glucose": 95.654321,
"heartrate": 90,
"heartrate_max": 180,
"heartrate_min": 60,
"heartrate_resting": 70,
"heartrate_resting_max": 85,
"heartrate_resting_min": 60,
"heartrate_zone0_duration": 5000,
"heartrate_zone1_duration": 7152,
"heartrate_zone2_duration": 25000,
"heartrate_zone3_duration": 18170,
"heartrate_zone4_duration": 6372,
"heartrate_zone5_duration": 2000,
"height": 1.7549,
"hrv_rmssd": 45,
"hrv_sdnn": 52,
"latitude": 37.77492948,
"longitude": -122.41941637,
"pace": 3.53,
"power": 125,
"power_max": 125,
"skin_temperature": 33.53,
"skin_temperature_max": 34.27,
"skin_temperature_min": 32.89,
"sleep_breathing_rate": 14.27,
"sleep_breathing_rate_max": 18.59,
"sleep_breathing_rate_min": 10.03,
"sleep_duration": 25200000,
"sleep_duration_awake": 1800000,
"sleep_duration_deep": 5400000,
"sleep_duration_light": 12600000,
"sleep_duration_nap": 3600000,
"sleep_duration_rem": 3600000,
"sleep_efficiency": 92,
"sleep_interruptions": 2,
"sleep_latency": 900000,
"sleep_score": 85,
"sleep_skin_temperature_deviation": -0.13,
"speed": 3.2516,
"speed_max": 8.5034,
"speed_min": 0.5016,
"spo2": 98.5016,
"spo2_max": 99.5034,
"spo2_min": 95.2516,
"steps": 8500,
"swimming_distance_per_stroke": 2.27,
"swimming_lengths": 40,
"vo2max": 45.23,
"wakeup_latency": 600000,
"weight": 70000.5034
}
}
],
"metrics": {
"air_temperature": 22.73,
"air_temperature_max": 28.55,
"air_temperature_min": 15.27,
"ascent": 320.29,
"basal_body_temperature": 36.53,
"basal_body_temperature_max": 37.03,
"basal_body_temperature_min": 36.01,
"bedtime_duration": 28800000,
"blood_pressure_diastolic": 80.03,
"blood_pressure_diastolic_max": 90.07,
"blood_pressure_diastolic_min": 60.01,
"blood_pressure_systolic": 120.03,
"blood_pressure_systolic_max": 140.07,
"blood_pressure_systolic_min": 100.01,
"body_bone_mass": 3200,
"body_fat": 18.53,
"body_fat_max": 25.03,
"body_fat_min": 12.01,
"body_mass_index": 22.5016,
"body_temperature": 36.73,
"body_temperature_max": 37.55,
"body_temperature_min": 36.13,
"breathing_rate": 16.5016,
"breathing_rate_max": 24.7549,
"breathing_rate_min": 12.2534,
"cadence": 85.5016,
"cadence_max": 110.0049,
"cadence_min": 60.0034,
"calories_burned": 1650.7549,
"calories_burned_active": 450.2516,
"calories_burned_basal": 1200.5034,
"calories_intake": 2100.5016,
"descent": 280.91,
"distance": 6500.2516,
"distance_cycling": 15000.7549,
"distance_running": 5000.5016,
"distance_swimming": 1000.7549,
"distance_walking": 3200.5034,
"distance_wheelchair": 2800.5034,
"duration_active": 5400000,
"duration_high_intensity": 1200000,
"duration_low_intensity": 9000000,
"duration_moderate_intensity": 2400000,
"ecg_rri": 850,
"ecg_voltage": 1200.53,
"elevation": 1050.73,
"elevation_gain": 450.83,
"elevation_loss": 380.47,
"elevation_max": 1250.55,
"elevation_min": 850.37,
"floors_climbed": 12,
"glucose": 95.654321,
"heartrate": 90,
"heartrate_max": 180,
"heartrate_min": 60,
"heartrate_resting": 70,
"heartrate_resting_max": 85,
"heartrate_resting_min": 60,
"heartrate_zone0_duration": 5000,
"heartrate_zone1_duration": 7152,
"heartrate_zone2_duration": 25000,
"heartrate_zone3_duration": 18170,
"heartrate_zone4_duration": 6372,
"heartrate_zone5_duration": 2000,
"height": 1.7549,
"hrv_rmssd": 45,
"hrv_sdnn": 52,
"latitude": 37.77492948,
"longitude": -122.41941637,
"pace": 3.53,
"power": 125,
"power_max": 125,
"skin_temperature": 33.53,
"skin_temperature_max": 34.27,
"skin_temperature_min": 32.89,
"sleep_breathing_rate": 14.27,
"sleep_breathing_rate_max": 18.59,
"sleep_breathing_rate_min": 10.03,
"sleep_duration": 25200000,
"sleep_duration_awake": 1800000,
"sleep_duration_deep": 5400000,
"sleep_duration_light": 12600000,
"sleep_duration_nap": 3600000,
"sleep_duration_rem": 3600000,
"sleep_efficiency": 92,
"sleep_interruptions": 2,
"sleep_latency": 900000,
"sleep_score": 85,
"sleep_skin_temperature_deviation": -0.13,
"speed": 3.2516,
"speed_max": 8.5034,
"speed_min": 0.5016,
"spo2": 98.5016,
"spo2_max": 99.5034,
"spo2_min": 95.2516,
"steps": 8500,
"swimming_distance_per_stroke": 2.27,
"swimming_lengths": 40,
"vo2max": 45.23,
"wakeup_latency": 600000,
"weight": 70000.5034
},
"provider_local_date": "2006-01-02",
"provider_slug": "strava",
"record_id": "12345678-1234-abcd-4321-abcdef123456",
"segments": [
{
"metrics": {
"air_temperature": 22.73,
"air_temperature_max": 28.55,
"air_temperature_min": 15.27,
"ascent": 320.29,
"basal_body_temperature": 36.53,
"basal_body_temperature_max": 37.03,
"basal_body_temperature_min": 36.01,
"bedtime_duration": 28800000,
"blood_pressure_diastolic": 80.03,
"blood_pressure_diastolic_max": 90.07,
"blood_pressure_diastolic_min": 60.01,
"blood_pressure_systolic": 120.03,
"blood_pressure_systolic_max": 140.07,
"blood_pressure_systolic_min": 100.01,
"body_bone_mass": 3200,
"body_fat": 18.53,
"body_fat_max": 25.03,
"body_fat_min": 12.01,
"body_mass_index": 22.5016,
"body_temperature": 36.73,
"body_temperature_max": 37.55,
"body_temperature_min": 36.13,
"breathing_rate": 16.5016,
"breathing_rate_max": 24.7549,
"breathing_rate_min": 12.2534,
"cadence": 85.5016,
"cadence_max": 110.0049,
"cadence_min": 60.0034,
"calories_burned": 1650.7549,
"calories_burned_active": 450.2516,
"calories_burned_basal": 1200.5034,
"calories_intake": 2100.5016,
"descent": 280.91,
"distance": 6500.2516,
"distance_cycling": 15000.7549,
"distance_running": 5000.5016,
"distance_swimming": 1000.7549,
"distance_walking": 3200.5034,
"distance_wheelchair": 2800.5034,
"duration_active": 5400000,
"duration_high_intensity": 1200000,
"duration_low_intensity": 9000000,
"duration_moderate_intensity": 2400000,
"ecg_rri": 850,
"ecg_voltage": 1200.53,
"elevation": 1050.73,
"elevation_gain": 450.83,
"elevation_loss": 380.47,
"elevation_max": 1250.55,
"elevation_min": 850.37,
"floors_climbed": 12,
"glucose": 95.654321,
"heartrate": 90,
"heartrate_max": 180,
"heartrate_min": 60,
"heartrate_resting": 70,
"heartrate_resting_max": 85,
"heartrate_resting_min": 60,
"heartrate_zone0_duration": 5000,
"heartrate_zone1_duration": 7152,
"heartrate_zone2_duration": 25000,
"heartrate_zone3_duration": 18170,
"heartrate_zone4_duration": 6372,
"heartrate_zone5_duration": 2000,
"height": 1.7549,
"hrv_rmssd": 45,
"hrv_sdnn": 52,
"latitude": 37.77492948,
"longitude": -122.41941637,
"pace": 3.53,
"power": 125,
"power_max": 125,
"skin_temperature": 33.53,
"skin_temperature_max": 34.27,
"skin_temperature_min": 32.89,
"sleep_breathing_rate": 14.27,
"sleep_breathing_rate_max": 18.59,
"sleep_breathing_rate_min": 10.03,
"sleep_duration": 25200000,
"sleep_duration_awake": 1800000,
"sleep_duration_deep": 5400000,
"sleep_duration_light": 12600000,
"sleep_duration_nap": 3600000,
"sleep_duration_rem": 3600000,
"sleep_efficiency": 92,
"sleep_interruptions": 2,
"sleep_latency": 900000,
"sleep_score": 85,
"sleep_skin_temperature_deviation": -0.13,
"speed": 3.2516,
"speed_max": 8.5034,
"speed_min": 0.5016,
"spo2": 98.5016,
"spo2_max": 99.5034,
"spo2_min": 95.2516,
"steps": 8500,
"swimming_distance_per_stroke": 2.27,
"swimming_lengths": 40,
"vo2max": 45.23,
"wakeup_latency": 600000,
"weight": 70000.5034
}
}
],
"sessions": [
{
"metrics": {
"air_temperature": 22.73,
"air_temperature_max": 28.55,
"air_temperature_min": 15.27,
"ascent": 320.29,
"basal_body_temperature": 36.53,
"basal_body_temperature_max": 37.03,
"basal_body_temperature_min": 36.01,
"bedtime_duration": 28800000,
"blood_pressure_diastolic": 80.03,
"blood_pressure_diastolic_max": 90.07,
"blood_pressure_diastolic_min": 60.01,
"blood_pressure_systolic": 120.03,
"blood_pressure_systolic_max": 140.07,
"blood_pressure_systolic_min": 100.01,
"body_bone_mass": 3200,
"body_fat": 18.53,
"body_fat_max": 25.03,
"body_fat_min": 12.01,
"body_mass_index": 22.5016,
"body_temperature": 36.73,
"body_temperature_max": 37.55,
"body_temperature_min": 36.13,
"breathing_rate": 16.5016,
"breathing_rate_max": 24.7549,
"breathing_rate_min": 12.2534,
"cadence": 85.5016,
"cadence_max": 110.0049,
"cadence_min": 60.0034,
"calories_burned": 1650.7549,
"calories_burned_active": 450.2516,
"calories_burned_basal": 1200.5034,
"calories_intake": 2100.5016,
"descent": 280.91,
"distance": 6500.2516,
"distance_cycling": 15000.7549,
"distance_running": 5000.5016,
"distance_swimming": 1000.7549,
"distance_walking": 3200.5034,
"distance_wheelchair": 2800.5034,
"duration_active": 5400000,
"duration_high_intensity": 1200000,
"duration_low_intensity": 9000000,
"duration_moderate_intensity": 2400000,
"ecg_rri": 850,
"ecg_voltage": 1200.53,
"elevation": 1050.73,
"elevation_gain": 450.83,
"elevation_loss": 380.47,
"elevation_max": 1250.55,
"elevation_min": 850.37,
"floors_climbed": 12,
"glucose": 95.654321,
"heartrate": 90,
"heartrate_max": 180,
"heartrate_min": 60,
"heartrate_resting": 70,
"heartrate_resting_max": 85,
"heartrate_resting_min": 60,
"heartrate_zone0_duration": 5000,
"heartrate_zone1_duration": 7152,
"heartrate_zone2_duration": 25000,
"heartrate_zone3_duration": 18170,
"heartrate_zone4_duration": 6372,
"heartrate_zone5_duration": 2000,
"height": 1.7549,
"hrv_rmssd": 45,
"hrv_sdnn": 52,
"latitude": 37.77492948,
"longitude": -122.41941637,
"pace": 3.53,
"power": 125,
"power_max": 125,
"skin_temperature": 33.53,
"skin_temperature_max": 34.27,
"skin_temperature_min": 32.89,
"sleep_breathing_rate": 14.27,
"sleep_breathing_rate_max": 18.59,
"sleep_breathing_rate_min": 10.03,
"sleep_duration": 25200000,
"sleep_duration_awake": 1800000,
"sleep_duration_deep": 5400000,
"sleep_duration_light": 12600000,
"sleep_duration_nap": 3600000,
"sleep_duration_rem": 3600000,
"sleep_efficiency": 92,
"sleep_interruptions": 2,
"sleep_latency": 900000,
"sleep_score": 85,
"sleep_skin_temperature_deviation": -0.13,
"speed": 3.2516,
"speed_max": 8.5034,
"speed_min": 0.5016,
"spo2": 98.5016,
"spo2_max": 99.5034,
"spo2_min": 95.2516,
"steps": 8500,
"swimming_distance_per_stroke": 2.27,
"swimming_lengths": 40,
"vo2max": 45.23,
"wakeup_latency": 600000,
"weight": 70000.5034
}
}
],
"splits": [
{
"metrics": {
"air_temperature": 22.73,
"air_temperature_max": 28.55,
"air_temperature_min": 15.27,
"ascent": 320.29,
"basal_body_temperature": 36.53,
"basal_body_temperature_max": 37.03,
"basal_body_temperature_min": 36.01,
"bedtime_duration": 28800000,
"blood_pressure_diastolic": 80.03,
"blood_pressure_diastolic_max": 90.07,
"blood_pressure_diastolic_min": 60.01,
"blood_pressure_systolic": 120.03,
"blood_pressure_systolic_max": 140.07,
"blood_pressure_systolic_min": 100.01,
"body_bone_mass": 3200,
"body_fat": 18.53,
"body_fat_max": 25.03,
"body_fat_min": 12.01,
"body_mass_index": 22.5016,
"body_temperature": 36.73,
"body_temperature_max": 37.55,
"body_temperature_min": 36.13,
"breathing_rate": 16.5016,
"breathing_rate_max": 24.7549,
"breathing_rate_min": 12.2534,
"cadence": 85.5016,
"cadence_max": 110.0049,
"cadence_min": 60.0034,
"calories_burned": 1650.7549,
"calories_burned_active": 450.2516,
"calories_burned_basal": 1200.5034,
"calories_intake": 2100.5016,
"descent": 280.91,
"distance": 6500.2516,
"distance_cycling": 15000.7549,
"distance_running": 5000.5016,
"distance_swimming": 1000.7549,
"distance_walking": 3200.5034,
"distance_wheelchair": 2800.5034,
"duration_active": 5400000,
"duration_high_intensity": 1200000,
"duration_low_intensity": 9000000,
"duration_moderate_intensity": 2400000,
"ecg_rri": 850,
"ecg_voltage": 1200.53,
"elevation": 1050.73,
"elevation_gain": 450.83,
"elevation_loss": 380.47,
"elevation_max": 1250.55,
"elevation_min": 850.37,
"floors_climbed": 12,
"glucose": 95.654321,
"heartrate": 90,
"heartrate_max": 180,
"heartrate_min": 60,
"heartrate_resting": 70,
"heartrate_resting_max": 85,
"heartrate_resting_min": 60,
"heartrate_zone0_duration": 5000,
"heartrate_zone1_duration": 7152,
"heartrate_zone2_duration": 25000,
"heartrate_zone3_duration": 18170,
"heartrate_zone4_duration": 6372,
"heartrate_zone5_duration": 2000,
"height": 1.7549,
"hrv_rmssd": 45,
"hrv_sdnn": 52,
"latitude": 37.77492948,
"longitude": -122.41941637,
"pace": 3.53,
"power": 125,
"power_max": 125,
"skin_temperature": 33.53,
"skin_temperature_max": 34.27,
"skin_temperature_min": 32.89,
"sleep_breathing_rate": 14.27,
"sleep_breathing_rate_max": 18.59,
"sleep_breathing_rate_min": 10.03,
"sleep_duration": 25200000,
"sleep_duration_awake": 1800000,
"sleep_duration_deep": 5400000,
"sleep_duration_light": 12600000,
"sleep_duration_nap": 3600000,
"sleep_duration_rem": 3600000,
"sleep_efficiency": 92,
"sleep_interruptions": 2,
"sleep_latency": 900000,
"sleep_score": 85,
"sleep_skin_temperature_deviation": -0.13,
"speed": 3.2516,
"speed_max": 8.5034,
"speed_min": 0.5016,
"spo2": 98.5016,
"spo2_max": 99.5034,
"spo2_min": 95.2516,
"steps": 8500,
"swimming_distance_per_stroke": 2.27,
"swimming_lengths": 40,
"vo2max": 45.23,
"wakeup_latency": 600000,
"weight": 70000.5034
}
}
]
}
]
}