Skip to main content
Question

Clubs endpoint documentation update


Forum|alt.badge.img+3

Can you please update the clubs documentation at https://developers.strava.com/docs/reference/#api-Clubs. The data returned does not match the docs and there is some limit to the pagination effecting the number of activities that can be returned. Many users ran into both these issues and posted on the old Google groups.

Hopefully when you document these it will become clear this endpoint needs to be improved as it's currently of very limited use.

Forum|alt.badge.img+20
  • Community Manager
  • January 18, 2023

Hi Nick, 

Thanks for the feedback!

Which data points are you finding returned that does not match our documentation so that we can take a look? The team just did an audit of a response returned by the get club activities endpoint and it matched up with our docs. We want to be sure to investigate what you're seeing on your end as well, thanks! 


Forum|alt.badge.img+3
  • Hub Rookie
  • January 19, 2023

Great, I see you have (at some point) updated the docs to show you return `MetaAthlete` objects within the `SummaryActivity` objects. This wasn't the case before. The `MetaAthlete` objects contain just a userid, this is useless... but at least it's accurate!


The other big issue is the number of `SummaryActivity` objects that are returned. There used to be a weird hard limit and it didn't respect the paging params. Did you fix that too?


Oh, and now there's a start datetime! I think that's new too. Wow, is this finally approaching something usable?!


Forum|alt.badge.img+4
  • Hub Rookie
  • January 19, 2023

I similarly often find discrepancies with the documentation.

Where is the start datetime you're talking about?


Forum|alt.badge.img+3
  • Hub Rookie
  • January 19, 2023

Forum|alt.badge.img+4
  • Hub Rookie
  • January 19, 2023

Right - however the response you get is not actually a SummaryActivity and rather a reduced version without starttime or id etc. as given in the docs

[ { "resource_state" : 2, "athlete" : { "resource_state" : 2, "firstname" : "Peter", "lastname" : "S." }, "name" : "World Championship", "distance" : 2641.7, "moving_time" : 577, "elapsed_time" : 635, "total_elevation_gain" : 8.8, "type" : "Ride", "sport_type" : "MountainBikeRide", "workout_type" : null } ]

 

 


Forum|alt.badge.img+3
  • Hub Rookie
  • January 19, 2023

Thanks @rorhug for checking. I wrongly assumed @Elliott11 and his team actually did what was claimed and things matched now. When will I learn.

So there you have it @Elliott11 it still doesn't match. please get your team to have another crack at it.


Forum|alt.badge.img+4
  • Hub Rookie
  • January 19, 2023

The example response on the right side matches and instead it's just the response type "SummaryActivity" which is wrong because "SummaryActivity" has a lot more detail.


Forum|alt.badge.img+20
  • Community Manager
  • January 19, 2023

@rorhug @Nick13 got it - we see where the inconsistency is now in the docs. The documented SummaryActivity model is out of sync with the documented response for club activities. I've added a ticket to get this updated. Apologies for any confusion and really appreciate you both flagging & talking through things here! 


Forum|alt.badge.img+3
  • Hub Rookie
  • January 19, 2023

Can you also please check the pagination? It has always been totally broken for this endpoint. There's some weird hard limit on how far back you can go.


Forum|alt.badge.img+20
  • Community Manager
  • January 19, 2023

You got it! 🙂 


Forum|alt.badge.img+20
  • Community Manager
  • February 1, 2023

@Nick13 @rorhug wanted to follow up and let you know that the documentation has been updated to now reflect a `ClubActivity` as opposed to the incorrect `SummaryActivity`. 


Forum|alt.badge.img+5
  • Hub Rookie
  • February 2, 2023

Hi @Elliott11 , it seems that the swagger json for this piece of the API spec (https://developers.strava.com/swagger/activity.json#/DetailedActivity) has become invalid because of this update. Can someone please correct it? Thanks!


Forum|alt.badge.img+20
  • Community Manager
  • February 2, 2023

Great catch! Just went in and fixed the JSON formatting.

Should be all good now, thanks for flagging! 


Forum|alt.badge.img+5
  • Hub Rookie
  • December 21, 2023

I also have the same question with you. I think there is no start date time in API documentation for Club Activity


Forum|alt.badge.img+3
  • Hub Rookie
  • December 21, 2023

I've since given up with this API. It's too frustrating. I have un-marked the solution until someone comes along and fixes this properly as per the other comments.


Reply


Cookie policy

We use cookies to enhance and personalize your experience. If you accept, you agree to our full cookie policy. Learn more about our cookies.

 
Cookie settings