A session message summarizes a period of a single sport within an activity. A run, a ride or a swim has exactly one session, while a triathlon has one per discipline (and transitions). It is where you find the totals and averages displayed at the end of an activity: duration, distance, speed, heart rate, power, cadence, elevation, calories, training effect and many more.
messageIndexStringIndex of the session in the activity, starting at 0.
Moment the session ended, in UTC.
eventEnumKind of event: timer, lap, session, activity, workout step, course point, battery, gear change, rider position change…
lengthsessionactivityworkoutlapworkoutStepcoursePointbatteryfitnessEquipmenttimerpowerDownpowerUpoffCoursevirtualPartnerPacehrHighAlerthrLowAlertspeedHighAlertspeedLowAlertcadHighAlertcadLowAlertpowerHighAlertpowerLowAlertrecoveryHrbatteryLowtimeDurationAlertdistanceDurationAlertcalorieDurationAlertuserMarkersportPointcalibrationfrontGearChangerearGearChangeriderPositionChangeelevHighAlertelevLowAlertcommTimeoutautoActivityDetectdiveAlertdiveGasSwitchedtankPressureReservetankPressureCriticaltankLostradarThreatAlerttankBatteryLowtankPodConnectedtankPodDisconnectedeventTypeEnumWhat happened for the event: start, stop, stopAll, marker, begin or end of a depreciated range…
stopstartmarkerconsecutiveDepreciatedstopAllbeginDepreciatedendDepreciatedendAllDepreciatedstopDisablestopDisableAllstartTimeDateTimeMoment the period described by the message started.
Latitude where the period started, in semicircles (multiply by 180 / 2^31 to get degrees).
Longitude where the period started, in semicircles (multiply by 180 / 2^31 to get degrees).
sportEnumMain sport, such as running, cycling, swimming, hiking or training.
allrunningtransitiongenericcyclingfitnessEquipmentswimmingbasketballsoccertennisamericanFootballtrainingwalkingcrossCountrySkiingalpineSkiingsnowboardingrowingmountaineeringhikingmultisportpaddlingflyingeBikingmotorcyclingboatingdrivinggolfhangGlidinghorsebackRidinghuntingfishinginlineSkatingrockClimbingsailingiceSkatingskyDivingsnowshoeingsnowmobilingstandUpPaddleboardingsurfingwakeboardingwaterSkiingkayakingraftingwindsurfingkitesurfingtacticaljumpmasterboxingfloorClimbingbaseballdivingshootingwinterSportgrindinghiitvideoGamingracketwheelchairPushWalkwheelchairPushRunmeditationparaSportdiscGolfteamSportcricketrugbyhockeylacrossevolleyballwaterTubingwakesurfingwaterSportarcherymixedMartialArtsmotorSportssnorkelingdancejumpRopepoolApneamobilitygeocachingcanoeingsubSportEnumRefinement of the sport, such as trail, treadmill or track for running, road, mountain or indoor for cycling, lapSwimming or openWater for swimming.
matchmapplatformalltracknavigatefieldgenerichiittreadmillstreettrailspinindoorCyclingroadmountaindownhillrecumbentcyclocrosshandCyclingtrackCyclingindoorRowingellipticalstairClimbinglapSwimmingopenWaterflexibilityTrainingstrengthTrainingwarmUpexercisechallengeindoorSkiingcardioTrainingindoorWalkingeBikeFitnessbmxcasualWalkingspeedWalkingbikeToRunTransitionrunToBikeTransitionswimToBikeTransitionatvmotocrossbackcountryresortrcDronewingsuitwhitewaterskateSkiingyogapilatesindoorRunninggravelCyclingeBikeMountaincommutingmixedSurfacetrackMesingleGasDivingmultiGasDivinggaugeDivingapneaDivingapneaHuntingvirtualActivityobstaclebreathingccrDivingsailRaceexpeditionultraindoorClimbingboulderingindoorGrindinghuntingWithDogsamrapemomtabataesporttriathlonduathlonbrickswimRunadventureRacetruckerWorkoutpickleballpadelindoorWheelchairWalkindoorWheelchairRunindoorHandCyclingiceultimatesquashbadmintonracquetballtableTennisoverlandtrollingMotorflyCanopyflyParaglideflyParamotorflyPressurizedflyNavigateflyTimerflyAltimeterflyWxflyVfrflyIfrdynamicApneaenduroruckingrallypoolTriathloneBikeEnduroTotal duration from start to end, pauses included (wall-clock time).
Duration during which the timer was running, pauses excluded. This is the time usually displayed as the duration.
Total distance covered.
Total number of cycles: pedal revolutions, strides or strokes depending on the sport.
Total number of repetitions.
Total number of strides.
Total number of strokes (swimming, paddling, rowing).
Total number of wheelchair pushes.
Total energy expenditure.
Share of the total calories coming from fat.
avgSpeedFloat64Average speed: total distance divided by timer time.
maxSpeedFloat64Maximum speed reached.
Average heart rate, pauses excluded.
Maximum heart rate reached.
Average cadence: revolutions per minute for cycling, steps per minute for running (depending on the sport).
Average running cadence, in strides per minute.
Average swimming cadence, in strokes per minute.
Average cadence for paddle sports (kayak, SUP, rowing), in strokes per minute.
Average number of wheelchair pushes per minute.
Maximum cadence reached.
Maximum running cadence, in strides per minute.
Maximum swimming cadence, in strokes per minute.
Maximum cadence for paddle sports, in strokes per minute.
Maximum number of wheelchair pushes per minute.
Average power output.
Maximum power output.
Cumulated elevation gain.
Cumulated elevation loss.
totalTrainingEffectFloat64Aerobic training effect, from 0 to 5: impact of the activity on aerobic fitness.
firstLapIndexUint16messageIndex of the first lap message belonging to this period.
numLapsUint16Number of laps.
eventGroupUint8Groups related events together, so that start and stop events of the same group can be paired.
triggerEnumWhat ended the session: activity end, manual, automatic multisport transition or fitness equipment.
manualfitnessEquipmentautoMultiSportactivityEndLatitude of the north-east corner of the bounding box containing the track, in semicircles.
Longitude of the north-east corner of the bounding box containing the track, in semicircles.
Latitude of the south-west corner of the bounding box containing the track, in semicircles.
Longitude of the south-west corner of the bounding box containing the track, in semicircles.
Number of pool lengths, rest lengths included.
Normalized power (NP): an estimate of the power that could have been sustained for the same physiological cost if the effort had been perfectly steady.
Training stress score (TSS): training load combining duration and intensity relative to the threshold power.
Intensity factor (IF): normalized power divided by threshold power.
leftRightBalanceEnumPower contribution of the right leg, when the right bit is set, as a percentage of the total. The left leg makes up the rest.
rightmaskLatitude where the period ended, in semicircles (multiply by 180 / 2^31 to get degrees).
Longitude where the period ended, in semicircles (multiply by 180 / 2^31 to get degrees).
Average number of strokes per lap.
Average distance covered at each stroke.
Swimming stroke: freestyle, backstroke, breaststroke, butterfly, drill, mixed or IM.
freestylebackstrokebreaststrokebutterflydrillmixedimimByRoundrimoLength of the pool.
Functional threshold power (FTP) used for the training stress and intensity computations.
poolLengthUnitEnumUnit system the pool length was entered in: metric or statute (yards).
metricstatutenauticalNumber of pool lengths actually swum.
Total mechanical work produced.
avgAltitudeFloat64Average altitude.
maxAltitudeFloat64Highest altitude reached.
Estimated accuracy of the GPS position.
Average slope.
Average slope while climbing.
Average slope while descending.
Steepest uphill slope.
Steepest downhill slope.
Average ambient temperature measured by the device.
Highest ambient temperature measured by the device.
Time spent actually moving, excluding the time stopped even when the timer was running.
Average vertical speed while climbing.
Average vertical speed while descending.
Maximum vertical speed while climbing.
Maximum vertical speed while descending.
Minimum heart rate recorded.
Time spent in each heart rate zone. The first element is the time below zone 1, then zone 1, zone 2 and so on.
Time spent in each speed zone.
Time spent in each cadence zone.
Time spent in each power zone. The first element is the time below zone 1, then zone 1, zone 2 and so on.
Average duration of the laps.
bestLapIndexUint16messageIndex of the fastest lap.
minAltitudeFloat64Lowest altitude reached.
Time spent actually moving or working, excluding rest periods and pauses.
Average number of strokes per pool length.
avgSwolfUint16Average SWOLF (swim golf) score: strokes plus seconds needed to swim a length. The lower, the more efficient.
playerScoreUint16Score of the user, for racket and team sports.
opponentScoreUint16Score of the opponent, for racket and team sports.
opponentNameStringName of the opponent.
Number of strokes for each stroke type (serve, forehand, backhand, smash…), indexed by stroke type.
Number of hits for each zone, indexed by zone number.
Maximum ball speed.
Average ball speed.
Average vertical oscillation: how much the torso moves up and down at each step.
Average ground contact time, as a percentage of the step duration.
Average ground contact time: how long each foot stays on the ground at each step.
Fractional part of avgCadence, to add to it for a more precise value.
Fractional part of maxCadence, to add to it for a more precise value.
Fractional part of totalCycles, to add to it for a more precise value.
Average total hemoglobin concentration, from a muscle oxygen sensor (one element per sensor).
Minimum total hemoglobin concentration, from a muscle oxygen sensor.
Maximum total hemoglobin concentration, from a muscle oxygen sensor.
Average muscle oxygen saturation (SmO2): share of hemoglobin carrying oxygen.
Minimum muscle oxygen saturation (SmO2).
Maximum muscle oxygen saturation (SmO2).
Average torque effectiveness of the left leg: share of the pedal stroke producing positive power.
Average torque effectiveness of the right leg: share of the pedal stroke producing positive power.
Average pedal smoothness of the left leg: how evenly power is applied across the stroke.
Average pedal smoothness of the right leg: how evenly power is applied across the stroke.
Average pedal smoothness of both legs combined, for single-sided power meters.
numSegmentLapsUint16Number of segment laps (segments raced) during the session.
frontGearShiftCountUint16Number of front derailleur shifts (electronic groupsets).
rearGearShiftCountUint16Number of rear derailleur shifts (electronic groupsets).
sportProfileNameStringName of the activity profile used on the device, such as "Trail Run" or "Road Bike".
sportIndexUint8Index of the sport profile used on the device during the activity.
Total time spent standing on the pedals.
standCountUint16Number of times the rider moved from seated to standing.
Average platform center offset of the left foot: how far from the center of the pedal the force is applied.
Average platform center offset of the right foot: how far from the center of the pedal the force is applied.
Average start and end angles of the left pedal stroke portion producing positive power.
Average start and end angles of the left pedal stroke portion producing peak power.
Average start and end angles of the right pedal stroke portion producing positive power.
Average start and end angles of the right pedal stroke portion producing peak power.
Average power for each rider position (seated, standing).
Maximum power for each rider position (seated, standing).
Average cadence for each rider position (seated, standing).
Maximum cadence for each rider position (seated, standing).
Average speed, with a larger range than avgSpeed. Prefer it when present.
Maximum speed, with a larger range than maxSpeed. Prefer it when present.
Average altitude, with a larger range than avgAltitude. Prefer it when present.
Lowest altitude, with a larger range than minAltitude. Prefer it when present.
Highest altitude, with a larger range than maxAltitude. Prefer it when present.
Average motor power of the light electric vehicle (e-bike).
Maximum motor power of the light electric vehicle (e-bike).
Battery consumed by the light electric vehicle (e-bike).
Average vertical ratio: vertical oscillation divided by step length. The lower, the more efficient.
Average ground contact time balance between left and right foot.
Average step length.
totalAnaerobicTrainingEffectFloat64Anaerobic training effect, from 0 to 5: impact of the activity on the capacity to perform high intensity efforts.
Average VAM (velocità ascensionale media): the vertical ascent speed while climbing.
Average depth. 0 when above water.
Maximum depth reached. 0 when above water.
Time spent at the surface since the end of the previous dive.
Central nervous system oxygen toxicity (CNS%) at the start of the dive.
Central nervous system oxygen toxicity (CNS%) at the end of the dive.
Nitrogen tissue loading at the start of the dive.
Nitrogen tissue loading at the end of the dive.
avgRespirationRateUint8Average respiration rate, in breaths per minute.
maxRespirationRateUint8Maximum respiration rate, in breaths per minute.
minRespirationRateUint8Minimum respiration rate, in breaths per minute.
Lowest ambient temperature measured by the device.
Whole-body oxygen toxicity accumulated during the dive, in oxygen toxicity units (OTU).
diveNumberUint32Sequence number of the dive in the diver log.
trainingLoadPeakFloat64Training load of the activity, estimated from excess post-exercise oxygen consumption (EPOC).
Average respiration rate, with more precision than avgRespirationRate. Prefer it when present.
Maximum respiration rate, with more precision than maxRespirationRate. Prefer it when present.
enhancedMinRespirationRateFloat64Minimum respiration rate, with more precision than minRespirationRate. Prefer it when present.
Grit score: how difficult the trail was, based on its slopes and sharp turns. The higher, the harder.
Flow score: how smoothly the rider kept their momentum through the trail. The lower, the smoother.
jumpCountUint16Number of jumps detected.
Average grit score: difficulty of the trail per unit of distance.
Average flow score: how smoothly the rider kept their momentum.
workoutFeelUint8How the user felt during the workout, from 0 (very weak) to 100 (very strong).
workoutRpeUint8Rate of perceived exertion (RPE) entered by the user, on a 0 to 10 scale multiplied by 10.
Average blood oxygen saturation (SpO2).
Average stress level.
Calories burned by the metabolism at rest during the period (basal metabolic rate), included in the total.
Heart rate variability as the standard deviation of the intervals between beats (SDRR).
Heart rate variability as the root mean square of successive differences between beats (RMSSD).
Fractional part of totalAscent, to add to it for a more precise value.
Fractional part of totalDescent, to add to it for a more precise value.
Average core body temperature, from a core temperature sensor.
Lowest core body temperature, from a core temperature sensor.
Highest core body temperature, from a core temperature sensor.
Average speed adjusted for the slope: the equivalent speed on flat ground for the same effort.
mesgNumStringGlobal message number identifying the kind of message. Decoders use it to know which profile to apply to the data.