Strength Training Activities

Introduction

Strength training activities appear in a user's fitness feed alongside cardio activities. Strength training activities are grouped in reverse chronological order in a strength training activity feed.

Strength Training Activity Feed

Because a user's activity feed can grow very large, feeds are divided into pages of twenty-five activities at a time. Each page contains links to the previous and next pages as well as the total number of activities across all pages. Each page of a user's activity feed has the following structure:

Content-Type
application/vnd.com.runkeeper.StrengthTrainingActivityFeed+json
Field Type Description
size Integer The total number of fitness activities across all pages
items Item[] The user’s activities, from newest to oldest
previous String The URI of the previous page in the user’s feed (omitted for the oldest page)
next String The URI of the next page in the user’s feed (omitted for the newest page)

Past Activities

Past activities have the following structure:

Note: The URIs for individual nearest-in-time measurements continue to use the "old" measurement format.

Content-Type
application/vnd.com.runkeeper.StrengthTrainingActivity+json
Field Type Description Editable
uri String The URI for this activity N
userID Integer The unique ID of the user for the activity N
start_time String The starting time for the activity (e.g., Sat, 1 Jan 2011 00:00:00) Y
total_calories Double The total calories burned (omitted if not available) Y
notes String Any notes that the user has associated with the activity (max. 1024 characters; optional) Y
exercises Exercise[] The exercises performed during this strength training activity Y
source String The name of the application that last modified this activity N
comments String The URI of the comment thread for this activity N
previous String The URI of the previous activity in the user's fitness feed (omitted for the oldest activity) N
next String The URI of the next activity in the user's fitness feed (omitted for the most-recent activity) N
nearest_fitness_activity String The URI of the fitness activity closest in time to this activity for the user (omitted if no fitness activities have been recorded) N
nearest_teammate_fitness_activities String[] The URIs of the fitness activities closest in time to this activity for each friend (empty if no fitness activities have been recorded) N
nearest_teammate_strength_training_activities String[] The URIs of the strength training activities closest in time to this activity for each friend (empty if no strength training activities have been recorded) N
nearest_background_activity String The URI of the background activity closest in time to this activity for the user (omitted if no background activities have been recorded) N
nearest_teammate_background_activities String[] The URIs of the background activities closest in time to this activity for each friend (empty if no background activities have been recorded) N
nearest_sleep String The URI of the sleep measurements closest in time to this activity for the user (omitted if no sleep measurements have been taken) N
nearest_teammate_sleep String[] The URIs of the sleep measurements closest in time to this activity for each friend (empty if no sleep measurements have been taken) N
nearest_nutrition String The URI of the nutrition measurement closest in time to this activity for the user (omitted if no nutrition measurements have been token) N
nearest_teammate_nutrition String[] The URIs of the nutrition measurement closest in time to this activity for each friend (empty if no nutrition measurements have been token) N
nearest_weight String The URI of the weight measurement closest in time to this activity for the user (omitted if no weight measurements have been token) N
nearest_teammate_weight String[] The URIs of the weight measurements closest in time to this activity for each friend (empty if no weight measurements have been token) N
nearest_general_measurement String The URI of the general measurement measurement closest in time to this activity for the user (omitted if no general measurements have been token) N
nearest_teammate_general_measurements String[] The URIs of the general measurements closest in time to this activity for each friend (empty if no general measurements have been token) N
nearest_diabetes String The URI of the diabetes measurement closest in time to this activity for the user (omitted if no diabetes measurements have been token) N
nearest_teammate_diabetes String[] The URIs of the diabetes measurements closest in time to this activity for each friend (empty if no diabetes measurements have been token) N

Newly-Completed Activities

Newly-completed activities have the following structure:

Content-Type
application/vnd.com.runkeeper.NewStrengthTrainingActivity+json
Field Type Description
start_time String The starting time for the activity (e.g., Sat, 1 Jan 2011 00:00:00)
notes String Any notes that the user has associated with the activity (max. 1024 characters; optional)
total_calories Double The total calories burned (omitted if not available)
exercises Exercise[] The exercises performed during this strength training activity
post_to_facebook Boolean True to post this activity to Facebook, false to prevent posting (optional; if not specified, the user's default preference is used)
post_to_twitter Boolean True to post this activity to Twitter, false to prevent posting (optional; if not specified, the user's default preference is used)

Array Structures

items

Field Type Description
start_time String The starting time for the activity (e.g., Sat, 1 Jan 2011 00:00:00)
uri String The URI of the detailed information for the activity

exercises

Field Type Description
primary_type String The primary exercise type, as one of the following values: Barbell Curl, Dumbbell Curl, Barbell Tricep Press, Dumbbell Tricep Press, Overhead Press, Wrist Curl, Tricep Kickback, Bench Press, Cable Crossover, Dumbbell Fly, Incline Bench, Dips, Pushup, Pullup, Back Raise, Bent-Over Row, Seated Row, Chinup, Lat Pulldown, Seated Reverse Fly, Military Press, Upright Row, Front Raise, Side Lateral Raise, Snatch, Push Press, Shrug, Crunch Machine, Crunch, Ab Twist, Bicycle Kick, Hanging Leg Raise, Hanging Knee Raise, Reverse Crunch, V Up, Situp, Squat, Lunge, Dead Lift, Hamstring Curl, Good Morning, Clean, Leg Press, Leg Extension, Other,
secondary_type String The secondary exercise type (optional; provides greater detail as free-form text if supplied)
primary_muscle_group String The primary muscle group, as one of the following values: Arms, Chest, Back, Shoulders, Abs, Legs
secondary_muscle_group String The secondary muscle group, as one of the following values: Arms, Chest, Back, Shoulders, Abs, Legs (optional)
routine String Free-form tag for the routine of which this exercise is a part (max. 32 characters; optional)
notes String Any notes for this exercise (max. 1024 characters; optional)
sets Set[] The sets performed during this exercise

sets

Field Type Description
weight Double The weight for the set, in kg
repetitions Integer The number of repetitions in this set
notes String Any notes for this set (max. 1024 characters; optional)

Supported Operations

Retrieving Activity Information

To retrieve a page of a user’s activity history or information for a past activity, GET its URI.

Retrieving Headers for a Past Activity

Header information for a past activity can be retrieved by making a HEAD request to its URI.

Editing a Past Activity

To edit a past activity, PUT any new values for editable fields to its URI.

Recording An Activity

To record a newly-completed activity, or to begin recording a live activity, POST its fields to any page in the user’s activity history.

Updating or Finishing a Live Activity

To update a live activity, or to finish recording one, POST to its URI.

Deleting an Activity

To delete an activity, DELETE its URI.