getActivityLaps
Retrieve per-lap splits from a Garmin activity's original .FIT file, including pace, heart rate, cadence, power, swim metrics, workout steps, and target verdicts for interval and per-km analysis.
Instructions
Laps of an activity as recorded by the watch (manual laps, auto-lap every km, or workout steps), read from the original .FIT file. One row per lap: distance (km), timer time, pace (min/km, foot sports) or speed (km/h), average/max HR, cadence (spm for running), ascent/descent, average power, running form (gctMs, vertRatioPct, vertOscCm, strideCm), intensity (active, interval, rest, recovery, warmup, cooldown; the auto laps of a free run can be interval), lap trigger, and the step of the planned workout (step: the reps of one drill share it). A swim lap also has metres, swimPace (per 100 m), stroke, lengths, swolf and strokes. Use it for intervals and per-km splits; getActivity does not have them. For a run: split (pace of the first and second half, kind, hrDriftPct) and, for a structured workout, work (reps, pace, avgHR, and the fade of each step with more than one rep, pct). For a swim: sets, the laps in a row of one distance, stroke and intensity (reps, firstPace, lastPace, pct: above 0 is slower, firstSwolf, lastSwolf). null is n/a. For a run, plan is the planned workout that the watch ran (null without one): its name and, per lap with a step in lap order, the step's target (type, low, high, unit; or zone), done (the lap in that unit), verdict (hit inside the target, ends included, or miss) and off (how far outside, in the unit: s/km for pace, above 0 is slower). An open or zone target, a target in %max or %ftp, a target outside a plausible range, a lap under 15 m or 8 s or a lap without the value has verdict null.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"activityId": "<activityId>"
},
"name": "getActivityLaps"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| activityId | Yes | Garmin activity id |