Requested permissions

read_activity
write_activity
copy
open
  • activities
  • notables
  • badges
  • stats
  • goals
  • body
  • userinfo
Get
Post
Put
Patch
Delete

UserName At present you can only retrieve your own data so this should always be "my" or the username of the authorized user (which are equivalent).

activities

https://api.smashrun.com/v1/my/activities

Use this to GET existing runs, POST new runs, PUT a replacement of an existing run, or PATCH a single field update to an existing run.

sample json
sample tcx
sample gpx
validate
execute
Line wrap off
request
response
Update selected fields of an activity (works only with the notes, duration, distance, and startDateTimeLocal fields)
ActivityId execute Unique id of an existing activity to update. https://api.smashrun.com/v1/my/activities/activityId
Flag an activity as deleted (activity may be undeleted by the user)
ActivityId execute Unique id of the activity to flag as deleted. https://api.smashrun.com/v1/my/activities/activityId
Get one full activity by id
ActivityId execute Unique id of the activity to retrieve. https://api.smashrun.com/v1/my/activities/activityId
Get a polyline representing the shape of the run. The values are string encodings of the latitude and longitude points using the encoded polyline algorithm, geojson, or SVG polyline format.
ActivityId execute Unique id of the activity of the polyline to retrieve. Return type
  • Google Encoded
  • SVG
  • GeoJSON
https://api.smashrun.com/v1/my/activities/activityId/polyline
Get splits for a run (stats over regular 1km or 1mi intervals)
ActivityId execute Unique id of the activity of the splits to retrieve. Return type
  • Kilometer
  • Mile
https://api.smashrun.com/v1/my/activities/activityId/splits
Get all activities in summary format (ordered by StartDate)
https://api.smashrun.com/v1/my/activities execute
Get activity summaries that are new or updated since a date
Date execute The API accepts unix timestamps (UTC), however if you pass an ISO 8601 date in the textbox we'll convert it for you.   
Return type
  • Summary
  • Brief
  • Id
  • Extended
https://api.smashrun.com/v1/my/activities/search?fromDate=1405439180
Get n most recent activity summaries
Count execute Count of the most recent activities to return ordered by UTC StartDateTime.
Return type
  • Summary
  • Brief
  • Id
  • Extended
https://api.smashrun.com/v1/my/activities/search?count=5
Get n most recent activity summaries starting on page k
Count
Count of the most recent activities to return ordered by UTC StartDateTime. Page execute 0 based index of the page of data to return
Return type
  • Summary
  • Brief
  • Id
  • Extended
https://api.smashrun.com/v1/my/activities/search?count=10&page=5
Line wrap off
Get
Post
Put
Delete

UserName At present you can only retrieve your own data so this should always be "my" or the username of the authorized user (which are equivalent).

activity notables

https://api.smashrun.com/v1/my/activities/{id}/notables

The activities notables endpoint can be used to GET the notables for an existing activity.

request
response
Get notables for a specified activity
ActivityId execute Unique id of the activity https://api.smashrun.com/v1/my/activities/activityId/notables
Line wrap off
Get
Post
Put
Delete

UserName At present you can only retrieve your own data so this should always be "my" or the username of the authorized user (which are equivalent).

badges

https://api.smashrun.com/v1/username/badges

The badges endpoint can be used to retrieve all of the badges a user has earned,

request
response
Get all badges a user has earned

https://api.smashrun.com/v1/my/badges execute

Check for any new badge awards (after adding a run)

https://api.smashrun.com/v1/my/badges/new execute

Line wrap off
Get
Post
Put
Delete

stats

https://api.smashrun.com/v1/my/stats

The stats endpoint can be used to get summary information about a user's running for a given month, year, or all time

request
response
Get stats for a given year and month
Year The year of the summary data. If left blank then all time summary will be returned Month execute 1 = January. If left blank year summary data will be returned.
https://api.smashrun.com/v1/my/activities/stats/2019/1
Line wrap off
Get
Post
Put
Delete

goals

https://api.smashrun.com/v1/my/goals

The goals endpoint can be used to get a user's running goal for a given month, year, or all time

request
response
Get goal for a given year and month
Year The year of the goal. If left blank then all goals will be returned Month execute 1 = January. If left blank then the goal for the year will be returned.
https://api.smashrun.com/v1/my/activities/goals/2019
Line wrap off
Get
Post
Put
Delete

body

https://api.smashrun.com/v1/my/body

The body endpoint can be used to get and save metrics about an athlete's body. Weight for now, but maybe one day: body fat, sleep, blood pressure, etc...

sample json
sample json
execute
Line wrap off
request
response
Get your most recent weight recording

https://api.smashrun.com/v1/my/body/weight/latest execute

Get all weight recordings

https://api.smashrun.com/v1/my/body/weight execute

Line wrap off
Get
Post
Put
Delete

body

https://api.smashrun.com/v1/my/userinfo

The userinfo endpoint returns information about the user associated with the current oauth token

sample json
sample json
execute
Line wrap off
request
response
Get info about current user

https://api.smashrun.com/v1/my/userinfo execute

Line wrap off
Okay