POpolar-com
Exercises (deprecated)

Get exercise summary

Changed on

Retrieve training session summary data

get/v3/users/{user-id}/exercise-transactions/{transaction-id}/exercises/{exercise-id}

Request

Path parameters

user-idinteger required

User identifier

transaction-idinteger required

Transaction identifier

exercise-idinteger required

Exercise identifier

Response

Exercise summary.

idinteger

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

transaction-idinteger

Id of the exercise-transaction this training was transferred in

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": 1937529874,
  "upload-time": "2008-10-13T10:40:0.000Z",
  "polar-user": "https://www.polaraccesslink/v3/users/1",
  "transaction-id": 179879,
  "device": "Polar M400",
  "device-id": "1111AAAA",
  "start-time": "2008-10-13T10:40:02",
  "start-time-utc-offset": 180,
  "duration": "PT2H44M45S",
  "calories": 530,
  "distance": 1600.2,
  "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": "RUNNING",
  "fat-percentage": 60,
  "carbohydrate-percentage": 38,
  "protein-percentage": 2,
  "running-index": 51,
  "training-load-pro": {
    "date": "2023-01-01",
    "cardio-load": 1,
    "muscle-load": 1,
    "perceived-load": 1
  }
}

Changes

  • f197848bba31Revision changes
    • info

      api tag Exercises (deprecated) added

    • info

      api tag Training data removed

  • 5ef2cea678a2Revision changes
    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: application/xml)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: application/xml)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: application/xml)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: application/xml)