Request: Steps-level breakdown for Running Activities (Start/End Time per Segment)

9306099 8 days ago

Hello Garmin Developer Team,

I am currently working with the Garmin API to retrieve detailed data from running activities. At the moment, I am able to obtain the laps correctly, but I also need access to steps-level breakdown for structured workouts.

More specifically, I need to know the exact timestamp range (start and end time in seconds) for each step of the workout:

Warm-up

Running intervals

Recovery

Cool-down

Any additional structured segments

This is essential for processing the activity with precision and segmenting the workout according to the user's training plan.

My question is:
Is this steps-level timing information available through any existing endpoint or FIT message?
If so, could you guide me on how to retrieve it or point me to the correct data type/message?

Thank you very much for your support.
Best regards

0 phoglund_ 8 days ago

If it's a structured workout that is initiated on the watch/device, then you have the information in the lap messages. The intensity field tell you what type of workout step it is.

You also have the info in split messages and the split summary gives you summaries of the different types.

0 Ben FIT 8 days ago

Lap mesgs contain a wkt_step_index field that will correspond to the message_index field of a workout_step mesg. The workout_step mesg will contain the workout step information that you are looking for.

0 9306099 8 days ago in reply to Ben FIT

Thanks for the explanation! I just have one question:
Which endpoint exactly are you referring to when you mention that the lap mesgs contain the wkt_step_index?

Are you talking about the endpoint that returns the FIT file for the activity, or is there a specific API endpoint that provides the workout_step data directly without having to parse the FIT file?

I want to confirm this so I make sure I’m using the correct data source. Thanks!