Get Workout
This endpoint returns detailed information about a single workout by its activity ID. It provides comprehensive workout data including all available metrics, breakdowns, and associated data points for the specified activity.
Workout Details
A single workout contains complete information about the activity:
- Base Information: Start time, end time, duration, user time offset, input method, and source provider
- Activity Metadata: Workout ID, name, type, and associated tags
- Metrics: Base metrics (distance, calories, duration) and provider-specific metrics
- Detailed Breakdowns: Sessions, laps, splits, segments, and route information
- Sample Data: Time-series data points with offsets, durations, and values
Data Components
The endpoint supports various inclusion parameters to customize the response:
- Sessions: Include workout session breakdowns with detailed metrics
- Laps: Include lap-by-lap data for structured activities with lap numbers
- Samples: Include detailed time-series data points with metric values
- Route Points: Include GPS coordinates and elevation data for route visualization
- Splits: Include split times and metrics for timed activities
- Segments: Include segment breakdowns for complex workouts
Sample Data Structure
When samples are included, the response contains time-series data with:
- Offsets: Time offsets from the workout start in milliseconds
- Durations: Duration of each data point in milliseconds
- Values: Metric values organized by metric type (heart rate, pace, etc.)
Route Information
Route points provide GPS and location data:
- Latitude/Longitude: Geographic coordinates for route visualization
- Elevation: Altitude data when available
- Timing: Precise timing information for each route point
Activity Breakdowns
Complex workouts may include multiple breakdowns:
- Sessions: Different phases or segments of the workout
- Laps: Individual laps for track or structured activities
- Splits: Time splits for performance analysis
- Segments: Custom segments defined by the activity
All timestamps in the response are in the UTC timezone.
Documentation Index
Fetch the complete documentation index at: https://docs.spikeapi.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workout ID
Query Parameters
Include sessions
Include laps
Include samples
Include route points
Include splits
Include segments
Response
OK
Modified at
Record ID
"12345678-1234-abcd-4321-abcdef123456"
Record start time
Record duration
Record end time
Data input method
unknown, manual, device If the record is already aggregated by the source, for example Apple Health aggregating steps from multiple devices
Metrics output
Provider local date
"2006-01-02"
Provider slugs
"strava"
"omron_eu"
"omron_us"
"health_connect"
"fitbit"
"garmin"
"huawei"
"dexcom"
"whoop"
"withings"
"suunto"
"apple"
"freestyle_libre"
"oura"
"polar"
"coros"
"ultrahuman"
"samsung_health_data"
"luna"
Source of the record according to the provider
apple_healthkit_sample, apple_healthkit_activity, apple_healthkit_sample_category, apple_healthkit_sleep_aggregation, apple_healthkit_statistics, apple_healthkit_characteristics, apple_healthkit_ecgs, apple_healthkit_mindfulness, health_connect_record, health_connect_activity, health_connect_mindfulness_session, health_connect_aggregation, fitbit_activities_list, fitbit_activities_daily_summary, fitbit_activities_daily_summary_activity, fitbit_activity_heart_intraday, fitbit_activity_steps_intraday, fitbit_activity_distance_intraday, fitbit_activity_calories_intraday, fitbit_hrv_summary, fitbit_hrv_intraday, fitbit_vo2max_summary, fitbit_sleep_summary, fitbit_activity_tcx, fitbit_br_summary, fitbit_br_intraday, fitbit_spo2_summary, fitbit_spo2_intraday, fitbit_core_temperature_summary, fitbit_skin_temperature_summary, fitbit_ecg, fitbit_body_log_fat, fitbit_body_log_weight, garmin_wellness_epochs, garmin_wellness_dailies, garmin_wellness_activities, garmin_wellness_activity_details, garmin_wellness_sleep, garmin_wellness_activity_file, garmin_wellness_hrv, garmin_wellness_user_metrics, garmin_wellness_body_comps, garmin_wellness_blood_pressures, garmin_wellness_stress_details, garmin_wellness_skin_temperature, oura_user_collection_daily_activity_document, oura_user_collection_sleep_document, oura_user_collection_workout_document, oura_user_collection_daily_spo2_document, oura_user_collection_vo2_max, oura_user_collection_hr_document, oura_user_collection_session_document, oura_personal_info, oura_user_collection_daily_sleep, polar_continuous_heart_rate_by_date, polar_exercise, polar_exercise_fit_file, polar_sleep_available, polar_activity_transaction, polar_activity_transaction_steps, polar_sleep_by_date, polar_nightly_recharge, polar_biosensing_spo2, polar_biosensing_body_temperature, polar_biosensing_skin_temperature, polar_physical_information, polar_biosensing_ecg, polar_user_info, strava_activity, suunto_workout_summary, suunto_workout_fit_file, suunto_activity_samples, suunto_activity_daily_summary, suunto_sleep_samples, whoop_cycle, whoop_cycle_recovery, whoop_activity_sleep, whoop_activity_workout, whoop_user_body_measurement, withings_sleep_summary, withings_sleep_get, withings_measure_workouts, withings_measure_activity, withings_measure_meas, withings_measure_activity_intraday, withings_heart_list, withings_heart_get, withings_sleep_combined, wahoo_workout_summary, wahoo_workout_fit_file, huawei_activity_record, huawei_sampling_data_daily_activity_summary, huawei_sampling_data_details, huawei_sampling_data_statistics, huawei_sampling_data_daily, huawei_health_record, huawei_sampling_data_latest, ultrahuman_heartrate_metrics, ultrahuman_hrv_metrics, ultrahuman_temp_metrics, ultrahuman_heartrate_resting_metrics, ultrahuman_steps_metrics, ultrahuman_vo2max_metrics, ultrahuman_glucose_metrics, ultrahuman_sleep_metrics, coros_workout, coros_workout_fit_file, coros_daily_record, coros_daily_record_sleep, samsung_health_data_aggregation, samsung_health_data_samples, samsung_health_data_user_profile, samsung_health_data_exercise, samsung_health_data_sleep, dexcom_egvs, freestyle_libre_glucose, luna_sleep, omron_us_blood_pressure, omron_us_hourly_activity, omron_us_weight, omron_us_temperature, omron_us_oxygen, omron_eu_blood_pressure, omron_eu_hourly_activity, omron_eu_weight, omron_eu_temperature, omron_eu_oxygen, map_my_fitness_workout, compat_apple_healthkit_entry, compat_health_connect_entry Provider source types
provider_summary, intraday_aggregation, activity_summary, activity_file, activity, sample, profile User time offset in minutes
Activity tags
on_foot, running, cycling, walking, gym, swimming, winter_sports, water_sports, team_sports, racket_sports, individual_sports, outdoor_recreation, dancing, martial_arts, wheelchair, climbing, workout, sleep, ecg, lab_report, mindfulness Activity types
other, sedentary, aerobics, play, house_work, gardening, work, sleep, workout, ecg_measurement, running, indoor_running, obstacle_run, street_running, track_running, trail_running, treadmill_running, ultra_running, virtual_running, triathlon, biathlon, duathlon, cycling, bmx_cycling, cyclocross_cycling, downhill_biking, e_bike_fitness, e_bike_mountain, gravel_cycling, indoor_cycling, mountain_biking, recumbent_cycling, road_biking, track_cycling, virtual_ride, hand_cycling, indoor_hand_cycling, rollerblading, skateboarding, skating, gym, bouldering, elliptical, indoor_cardio, hiit, indoor_climbing, indoor_rowing, pilates, stair_climbing, strength_training, yoga, meditation, rope_skipping, gymnastics, core_training, mixed_training, crossfit, calisthenics, warm_up, cool_down, flexibility_training, weight_lifting, functional_fitness, stretching, swimming, open_water_swimming, walking, casual_walking, speed_walking, hiking, stroller, winter_sports, backcountry_snowboarding, backcountry_skiing, cross_country_classic_skiing, skiing, snowboarding, skiing_snowboarding, cross_country_skate_skiing, skating_skiing, snow_shoeing, snowmobiling, curling, water_sports, boating, kayaking, kiteboarding, offshore_grinding, onshore_grinding, paddling, rowing, sailing, snorkeling, stand_up_paddleboarding, surfing, wakeboarding, waterskiing, whitewater_rafting, windsurfing, canoeing, team_sports, american_football, baseball, basketball, cricket, field_hockey, ice_hockey, lacrosse, rugby, soccer, softball, disc, volleyball, australian_football, handball, water_polo, floorball, netball, paintball, polo, racket_sports, badminton, padel, pickleball, platform_tennis, racquetball, squash, table_tennis, tennis, paddle_ball, martial_arts, boxing, mixed_martial_arts, kickboxing, muay_thai, wrestling, judo, karate, taekwondo, aikido, capoeira, kung_fu, tai_chi, jiu_jitsu, dancing, barre, climbing, wheelchair_push_run, wheelchair_push_walk, archery, bowling, fencing, golf, jumping, parkour, equestrian, hunting, fishing, diving, outdoor_recreation, geocaching, orienteering, bootcamp, motorsports, horseriding, paragliding, multisport, blood_test, mindfulness_session 