Sign in

v3

latestOpenAPI 3.1.02026-07-31121144224.9 KB
System: Vendor Workouts

Get User Workouts

Get workouts/exercises/activities from fitness provider API for a specific user.

  • Suunto: Returns workouts with pagination support
  • Polar: Returns exercises (Polar's term for workouts)
  • Garmin: Returns activities from Health API

Requires valid API key and active connection for the user.

get/api/v1/providers/{provider}/users/{user_id}/workouts

Path parameters

provider'apple' | 'samsung' | 'garmin' | 'google' | 'polar' | 'suunto' | 'whoop' | 'strava' | 'oura' | 'fitbit' | 'ultrahuman' | 'sensorbio' | 'unknown' | 'internal' required

Supported data providers.

Workout data provider

user_idstring uuid required

Query parameters

sinceinteger

Unix timestamp to get workouts since (0 = all, Suunto only)

Unix timestamp to get workouts since (0 = all, Suunto only)

limitinteger

Maximum number of workouts (Suunto: max 100)

Maximum number of workouts (Suunto: max 100)

offsetinteger

Offset for pagination (Suunto only)

Offset for pagination (Suunto only)

filter_by_modification_timeboolean

Filter by modification time instead of creation time (Suunto only)

Filter by modification time instead of creation time (Suunto only)

samplesboolean

Return sample data (Polar only)

Return sample data (Polar only)

zonesboolean

Return zones data (Polar only)

Return zones data (Polar only)

routeboolean

Return route data (Polar only)

Return route data (Polar only)

summary_start_timestring nullable

Activity start time as Unix timestamp or ISO 8601 date (Garmin only)

Activity start time as Unix timestamp or ISO 8601 date (Garmin only)

summary_end_timestring nullable

Activity end time as Unix timestamp or ISO 8601 date (Garmin only)

Activity end time as Unix timestamp or ISO 8601 date (Garmin only)

Headers

X-Open-Wearables-API-Keystring nullable

Response

Successful Response

object required
OR
object[] required