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.

July 3, 2024

• Activities with hidden start time on Strava will return an obscured start time of midnight + 1 second in the start_date and start_date_local fields. Example: "start_date_local": "2024-07-02T00:00:01Z"

January 8, 2024

• Introduction of route waypoints. This is a list of objects representing Custom Waypoints for routes that have them.

November 9, 2023

• Update webhook subscription DELETE to accept query parameters. See webhooks documentation.

August 22, 2023

• Bug fix: Gear name on activities now returned in full [Brand + Model + Nickname].

Oct 18, 2022

• Deprecate page and per_page params on the activity comments endpoint. Please start using page_size and after_cursor instead to request paginated results. Responses provided using the new query params include an additive, backwards compatible change, populating the cursor field 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 type and 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

• Deprecate start_latitude, start_longitude, end_latitude, and 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 start_latlng/end_latlng per our API documentation, which contains the values as an array pair instead.

October 26th, 2021

• Add hide_from_home to 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

• Add created_at, updated_at and estimated_moving_time to Routes model.

June 29th, 2020

• Add athlete_segment_stats to Segment model.
• Add athlete_pr_effort.activity_id to Segment Explore model.

June 5th, 2020

• Changed all id to 64-bit integers.
• Add id_str to 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 start_date_local and 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

• Add upload_id_str to athlete detail and id_str to upload detail in case your app cannot handle 64-bit integers.

January 17, 2019

• Remove email from athlete summary and athlete detail.

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

• Add route TCX export and GPX export.

July 26, 2018

• weight is 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/authorize returns 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_124 is 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

• Add owner_id to club detail.
• Add endpoints to approve club membership, decline club membership, promote a club admin, and revoke a club admin.

August 3, 2017

• Add type and after to list routes endpoint.
• Add created_at and updated_at to route detail endpoint, and deprecate timestamp.

August 1, 2017

• Deprecate club announcements endpoint.

July 24, 2017

• Replace athlete detail with athlete summary on OAuth token exchange.
• Add email to athlete summary endpoint.

June 27, 2017

• Add PR counts to activity summary endpoint.

April 10, 2017

• Add pagination & estimated_moving_time to route detail endpoint.

March 20, 2017

• Add name to 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

• Add start_latlng to group event summary endpoint.

February 3, 2017

• Add joined to 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.
• Deprecate route_id fields in group event summary group event detail.

December 12, 2016

• Add club representations
• Deprecate club_id fields in group event summary and group event detail.

December 9, 2016

• Add joined field to group event detail.

December 9, 2016

• Add group event join and leave endpoints.

December 5, 2016

• Add laps and pace zones to activity detail endpoint.
• Add a laps-specific endpoint.

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

• Add featured running races.

September 21, 2016

• Add brand guidelines.

August 31, 2016

• Add ability to star and unstar a segment.

August 25, 2016

• Add city, state and country to club summary endpoint.

June 30, 2016

• Add power zones to athlete zones endpoint.

June 27, 2016

• Add private to club summary endpoint.

June 9, 2016

• Add vanity url to club detail and club summary endpoints.

June 2, 2016

• Add new athlete zones endpoint to display heart rate zones.

May 13, 2016

• Add club admin and owner statuses to club detail endpoint.

May 9, 2016

• Add following_count to 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 private clubs.

April 21, 2016

• Add device name to activity detail endpoint.

April 20, 2016

• Add club membership status to club detail endpoint.

April 13, 2016

• Update club detail for invite-only clubs to be visible to non-members.

March 21, 2016

• Add has_heartrate to activity detail endpoint.

December 29, 2015

• Add swim stats to athlete stats endpoint.

December 23, 2015

• Add elev_high, elev_low, max_watts to activity summary and activity detail endpoints.

December 11, 2015

• Add route and route streams endpoints.

December 10, 2015

• Move activity location attribute deprecation to December 18, 2016.

December 3, 2015

• Include suffer_score in activity summary endpoint.

November 23, 2015

• Deprecate activity location attributes.

October 8, 2015

• Add embed token to activity detail endpoint.

September 25, 2015

• Remove CrossCountrySkiing from list of valid activity types on activity summary and activity detail endpoints.

September 25, 2015

• Add hazardous attribute to segment summary.

July 17, 2015

• Add trainer option to activity create endpoint.
• Add commute option to activity upload endpoint.

July 16, 2015

• Add private and commute options to activity create endpoint.

June 12, 2015

• Remove trucated from activity summary and activity detail endpoints.

June 12, 2015

• Clarify updating athlete gender.

June 5, 2015

• Document total_photo_count parameter on activity summary and activity detail endpoints.

May 18, 2015

• Add athlete_type to athlete detail endpoint.

April 27, 2015

• Add club group events endpoint.

April 7, 2015

• Document photo-specific changes to activity detail and photos summary endpoints.

April 6, 2015

• Add club announcements endpoint.

March 10, 2015

• Add weight to athlete detail endpoint.

February 7, 2015

• Document athlete stats and segment leaderboard endpoints.

December 29, 2014

• Document activity related (group activity) endpoint.

December 18, 2014

• Add join club and leave club.
• Add TCX support for ‘hiking’, ‘walking’, and ‘swimming’.

September 23, 2014

• Add weighted_average_watts to the activity summary endpoint
• Add documentation about the generic “with barometer” device.

September 5, 2014

• Add device_watts to 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

• Add starred to segment summary and remove pr_effort_id, pr_time and pr_distance.
• Add star_count to segment detail endpoint.

June 3, 2014

• Add average_cadence, average_watts, average_heartrate and max_heartrate to the segment effort endpoint.
• Remove bike_weight and athlete_weight from the activity zones endpoint.

April 7, 2014

• Add list segment efforts endpoint to list segment efforts filtered by date and athlete.

March 17, 2014

• Remove calories attribute from the activity summary endpoint.

February 26, 2014

• Rename activity upload parameter stationary to trainer for consistency throughout the API.

February 10, 2014

• Add hidden attribute 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_id on activity update.

January 31, 2014

• Add pr_effort_id to segment summary.
• Include pr_distance and pr_time in segment summary in addition to segment detaile.

January 24, 2014

• Add segment leaderboard pagination.

January 12, 2014

• Add location_country to athlete, activity, segment and club summary endpoints.

January 8, 2014

• Remove gear object from activity summary, provide gear_id instead.
• Add activity laps endpoint.

January 6, 2014

• Expand club detail to include more attributes such as description, type, location, etc.
• Add endpoint to delete activity.