Exercises

Get exercise

Changed on Jun 4, 2025

Get users exercise using hashed id. Only Exercises uploaded to Flow in the last 30 days are available. Only exercises that have been uploaded to Flow after the user is registered with your client will be available. Use samples and zones query parameters to return optional samples and zone information of the exercise.

get/v3/exercises/{exerciseId}

Request

Base URL
https://www.polaraccesslink.com
Auth
OAuth 2
Authorization codehttps://flow.polar.com/oauth2/authorization
Token URLhttps://polarremote.com/v2/oauth2/token
Scopesaccesslink.read_all
TypeScript
https://skmtc.dev/polar-com/apis/polar-accesslink-api/docs/v3/exercises/:exerciseId/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

exerciseIdstring required

Hashed exercise id.

Query parameters

samplesboolean

Return all sample data for this exercise.

zonesboolean

Return all zones data for this exercise.

routeboolean

Return all route data for this exercise.

Response

Exercise information.

idstring

Hashed id of the training session

upload_timestring

Time of the transfer from wrist unit to Polar database

polar_userstring

Absolute link to Polar user owning the training

devicestring

Polar product used in training

device_idstring

Id of the Polar device

start_timestring

Start time of the training session in local time

start_time_utc_offsetinteger

The offset from UTC (in minutes) when the training session was started

durationstring

The duration of the training session as specified in ISO8601

caloriesinteger

Expended calories during training in kilocalories

distancenumber float

Distance in meters travelled during training

training_loadnumber float

Training load effect to user

sportstring

Sport name

has_routeboolean

Boolean indicating if the exercise has route data

club_idinteger

Has value if the exercise is from "Flow For Club", otherwise not printed. Value -1 indicates that there were errors finding the club

club_namestring

Has value if the exercise is from "Flow For Club", otherwise not printed. Value "Ambiguous club location. Please contact support." is printed in case of error (and the club-id is -1).

detailed_sport_infostring

String containing the name of a Polar Flow-compatible sport, if one is set for the exercise.

fat_percentageinteger

Fat percentage of exercise calories. Has value if the exercise is from training device supporting Energy sources, otherwise not printed.

carbohydrate_percentageinteger

Carbohydrate percentage of exercise calories. Has value if the exercise is from training device supporting Energy sources, otherwise not printed.

protein_percentageinteger

Protein percentage of exercise calories. Has value if the exercise is from training device supporting Energy sources, otherwise not printed.

running-indexinteger

<a href="https://support.polar.com/en/support/tips/Running_Index_feature#"> Running index</a> is a score automatically calculated every run based on your heart rate and speed data collected via GPS or stride sensor.

Example response

{
  "id": "2AC312F",
  "upload_time": "2008-10-13T10:40:02.000Z",
  "polar_user": "https://www.polaraccesslink/v3/users/1",
  "device": "Polar M400",
  "device_id": "1111AAAA",
  "start_time": "2008-10-13T10:40:02",
  "start_time_utc_offset": 180,
  "duration": "PT2H44M",
  "calories": 530,
  "distance": 1600,
  "heart_rate": {
    "average": 129,
    "maximum": 147
  },
  "training_load": 143.22,
  "sport": "OTHER",
  "has_route": true,
  "club_id": 999,
  "club_name": "Polar Club",
  "detailed_sport_info": "WATERSPORTS_WATERSKI",
  "fat_percentage": 60,
  "carbohydrate_percentage": 38,
  "protein_percentage": 2,
  "running-index": 51,
  "heart_rate_zones": [
    {
      "index": 1,
      "lower-limit": 110,
      "upper-limit": 130,
      "in-zone": "PT4S"
    }
  ],
  "samples": [
    {
      "recording-rate": 5,
      "sample-type": "1",
      "data": "0,100,102,97,97,101,103,106,96,89,88,87,98,108,113,112,114,115,118,121,121,121,121,123,117,119,122"
    }
  ],
  "route": [
    {
      "latitude": 60.21982833,
      "longitude": 25.13925,
      "time": "PT210.026S",
      "satellites": 4,
      "fix": 1
    }
  ],
  "training_load_pro": {
    "date": "2023-01-01",
    "cardio-load": 1,
    "muscle-load": 1,
    "perceived-load": 1
  }
}

Changes

Jun 4, 20255ef2cea678a2 Revision changes
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the new optional query request parameter route
- info
  added the new optional query request parameter samples
- info
  added the new optional query request parameter zones
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Feb 25, 2021425d64c3dd59 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history