Strava V3 API Changelog
The Strava mobile applications and 3rd party applications use the V3 API to communicate with Strava. The Strava API Team strives to provide a stable interface with clear documentation. It is important to maintain a clear record of functional changes to the V3 API; the changelog is the official external record of these changes.
November 9, 2023
- Update webhook subscription DELETE to accept query parameters. See webhooks documentation.
August 22, 2023
- Bug fix: Gear
nameon activities now returned in full [Brand + Model + Nickname].
Oct 18, 2022
per_pageparams on the activity comments endpoint. Please start using
after_cursorinstead to request paginated results. Responses provided using the new query params include an additive, backwards compatible change, populating the
cursorfield on each comment.
June 15, 2022
Introduction of activity
sport_type. This is the preferred field to use moving forward, as opposed to
type, which is now considered deprecated. Please note: this change is backward compatible and
type will still be supported. The
SportType enumeration is distinct from
ActivityType in that it includes new types (e.g. MountainBikeRide). In requests where both
sport_type are present,
type will be ignored.
February 25, 2022
- Introduce ability to generate new client secret for application in API Settings on the My API Application page.
February 1, 2022
end_longitude. Endpoints that retrieve activities and segments will start to return null values starting February 28, 2022, and will be removed completely by March 31st, 2022. Please use
end_latlngper our API documentation, which contains the values as an array pair instead.
October 26th, 2021
hide_from_hometo activity update endpoint for mute activity.
October 1st, 2021
- Deprecate Running Races. The get running race and list races endpoints will start to return empty values starting October 15th, 2021, and will be removed completely by November 1st, 2021.
July 5th, 2020
estimated_moving_timeto Routes model.
June 29th, 2020
athlete_segment_statsto Segment model.
athlete_pr_effort.activity_idto Segment Explore model.
June 5th, 2020
- Changed all
idto 64-bit integers.
id_strto routes in case your app cannot handle 64-bit integers.
May 18, 2020
- Various Segment Changes.
May 8, 2020
- Improved list segment effort endpoint at a new URI. Added
end_date_local. The old endpoint is deprecated and will redirect to the new URI as on June 18th, 2020.
December 9, 2019
- The URL for managing push subscriptions (webhooks) has been updated and some improvements have been made to the underlying subscription management system. Push subscriptions no longer use https://api.strava.com/api/v3/, and instead may be managed through the normal Strava API: https://www.strava.com/api/v3/. The old endpoint, https://api.strava.com/api/v3 is deprecated and will no longer work for managing webhook subscriptions. See webhooks documentation.
October 15, 2019
- Migration period of forever access token ended. All apps must use the improved OAuth with refresh tokens and new scopes.
August 1, 2019
upload_id_strto athlete detail and
id_strto upload detail in case your app cannot handle 64-bit integers.
January 17, 2019
January 8, 2019
- Enforce TLS 1.2. Connections made via TLS versions before 1.2 are no longer supported.
December 4, 2018
- Mobile OAuth is available starting with Strava app version 75.0.
- Deprecate mobile webviews for OAuth.
October 15, 2018
- Improved OAuth with refresh tokens and new scopes.
July 27, 2018
July 26, 2018
weightis the only recognized parameter for athlete update. The endpoint will fail silently on other parameters until September 1st, 2018. After that an exception will be thrown.
May 25, 2018
GET https://www.strava.com/oauth/authorizereturns the scope of the eventual token in the response.
May 18, 2018
- Add the deauthorization webhook events.
January 17, 2018
- Athlete-specific data requires authentication.
January 16, 2018
- Release the activity-update webhook events system.
November 9, 2017
- Update Premium weight classes so that
0_124is the bottom bucket for the segment leaderboard endpoint.
October 19, 2017
- Add expanded Premium weight classes and age groups to segment leaderboard endpoint.
October 11, 2017
- Delete club announcements endpoint.
August 29, 2017
owner_idto club detail.
- Add endpoints to approve club membership, decline club membership, promote a club admin, and revoke a club admin.
August 3, 2017
afterto list routes endpoint.
updated_atto route detail endpoint, and deprecate
August 1, 2017
- Deprecate club announcements endpoint.
July 24, 2017
- Replace athlete detail with athlete summary on OAuth token exchange.
June 27, 2017
- Add PR counts to activity summary endpoint.
April 10, 2017
- Add pagination &
estimated_moving_timeto route detail endpoint.
March 20, 2017
nameto route meta endpoint.
March 9, 2017
- Add schedule-related fields to group event detail endpoint.
March 1, 2017
- Add endpoint to delete group event.
February 24, 2017
start_latlngto group event summary endpoint.
February 3, 2017
joinedto group event summary endpoint.
January 17, 2017
- Remove delete activity endpoint.
January 9, 2017
- Add name to club meta endpoint.
December 20, 2016
- Add group event endpoint.
December 15, 2016
- Add route meta representation.
route_idfields in group event summary group event detail.
December 12, 2016
club_idfields in group event summary and group event detail.
December 9, 2016
joinedfield to group event detail.
December 9, 2016
- Add group event join and leave endpoints.
December 5, 2016
December 2, 2016
- Restructure club group events into a new page.
December 2, 2016
- Update club members endpoint to respect Enhanced Privacy Mode.
November 2, 2016
September 21, 2016
- Add brand guidelines.
August 31, 2016
- Add ability to star and unstar a segment.
August 25, 2016
countryto club summary endpoint.
June 30, 2016
- Add power zones to athlete zones endpoint.
June 27, 2016
privateto club summary endpoint.
June 9, 2016
June 2, 2016
- Add new athlete zones endpoint to display heart rate zones.
May 13, 2016
- Add club
ownerstatuses to club detail endpoint.
May 9, 2016
following_countto club detail endpoint.
May 2, 2016
- Add club admins endpoint.
April 26, 2016
- New sort orders for club members endpoint.
April 22, 2016
- Update club join for
April 21, 2016
- Add device name to activity detail endpoint.
April 20, 2016
- Add club
membershipstatus to club detail endpoint.
April 13, 2016
- Update club detail for invite-only clubs to be visible to non-members.
March 21, 2016
has_heartrateto activity detail endpoint.
December 29, 2015
- Add swim stats to athlete stats endpoint.
December 23, 2015
December 11, 2015
- Add route and route streams endpoints.
December 10, 2015
- Move activity location attribute deprecation to December 18, 2016.
December 3, 2015
suffer_scorein activity summary endpoint.
November 23, 2015
- Deprecate activity location attributes.
October 8, 2015
- Add embed token to activity detail endpoint.
September 25, 2015
CrossCountrySkiingfrom list of valid activity types on activity summary and activity detail endpoints.
September 25, 2015
hazardousattribute to segment summary.
July 17, 2015
traineroption to activity create endpoint.
commuteoption to activity upload endpoint.
July 16, 2015
commuteoptions to activity create endpoint.
June 12, 2015
June 12, 2015
- Clarify updating athlete gender.
June 5, 2015
May 18, 2015
athlete_typeto athlete detail endpoint.
April 27, 2015
- Add club group events endpoint.
April 7, 2015
April 6, 2015
- Add club announcements endpoint.
March 10, 2015
weightto athlete detail endpoint.
February 7, 2015
December 29, 2014
- Document activity related (group activity) endpoint.
December 18, 2014
September 23, 2014
weighted_average_wattsto the activity summary endpoint
- Add documentation about the generic “with barometer” device.
September 5, 2014
device_wattsto athlete activities, which indicates if the source of the power data is a device or Strava’s estimate.
August 26, 2014
- Add new activity types.
August 11, 2014
- Represent segment effort IDs ith 64-bit datatypes.
July 24, 2014
- Add list starred segments endpoint for any athlete.
June 15, 2014
starredto segment summary and remove
star_countto segment detail endpoint.
June 3, 2014
max_heartrateto the segment effort endpoint.
athlete_weightfrom the activity zones endpoint.
April 7, 2014
- Add list segment efforts endpoint to list segment efforts filtered by date and athlete.
March 17, 2014
caloriesattribute from the activity summary endpoint.
February 26, 2014
- Rename activity upload parameter
trainerfor consistency throughout the API.
February 10, 2014
hiddenattribute to segment effort objects returned as part of an activity detail response.
February 3, 2014
- Allow the clearing of gear from an activity by passing ‘none’ for
gear_idon activity update.
January 31, 2014
pr_effort_idto segment summary.
pr_timein segment summary in addition to segment detaile.
January 24, 2014
- Add segment leaderboard pagination.