Clubs

Clubs represent groups of athletes on Strava. They can be public or private. The object is returned in summary or detailed representations.

Detailed representation attributes  

id: integer
resource_state: integer
indicates level of detail
name: string
profile_medium: string
URL to a 60x60 pixel profile picture
profile: string
URL to a 124x124 pixel profile picture
cover_photo: string
URL to a ~1185x580 pixel cover photo
cover_photo_small: string
URL to a ~360x176 pixel cover photo
description: string
club_type: string
casual_club, racing_team, shop, company, other
sport_type: string
cycling, running, triathlon, other
city: string
state: string
country: string
private: boolean
member_count: integer
featured: boolean
verified: boolean
membership: string
membership status of the requesting athlete
"member", "pending", null (not a member and have not requested join)
admin: boolean
true only if the requesting athlete is a club admin
owner: boolean
true only if the requesting athlete is the club owner
following_count: integer
total number of members the authenticated user is currently following
url string
vanity club URL slug

Summary representation attributes  

id: integer
resource_state: integer
indicates level of detail
name: string
profile_medium: string
URL to a 60x60 pixel profile picture
profile: string
URL to a 124x124 pixel profile picture
cover_photo: string
URL to a ~1185x580 pixel cover photo
cover_photo_small: string
URL to a ~360x176 pixel cover photo
sport_type: string
cycling, running, triathlon, other
city: string
state: string
country: string
private: boolean
member_count: integer
featured: boolean
verified: boolean
url string
vanity club URL slug

Meta representation attributes  

id: integer
resource_state: integer
indicates level of detail
name: string

Example club

{
  "id": 1,
  "resource_state": 3,
  "name": "Team Strava Cycling",
  "profile_medium": "http://pics.com/clubs/1/medium.jpg",
  "profile": "http://pics.com/clubs/1/large.jpg",
  "cover_photo": "http://pics.com/clubs/1/cover/large.jpg",
  "cover_photo_small": "http://pics.com/clubs/1/cover/small.jpg",
  "description": "From the people who brought you strava.com",
  "club_type": "company",
  "sport_type": "cycling",
  "city": "San Francisco",
  "state": "California",
  "country": "United States",
  "private": true,
  "member_count": 71,
  "featured": false,
  "verified": false,
  "membership": "member",
  "admin": true,
  "owner": false,
  "following_count": 1,
  "url": "strava-cycling"
}

 

Retrieve a club

Retrieve details about a specific club.

Parameters

id: integer required

Returns a detailed club representation.

Definition

GET https://www.strava.com/api/v3/clubs/:id

Example request

$ curl -G https://www.strava.com/api/v3/clubs/1 \
    -H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"

 

List club announcements

Announcements are posts sent by Club Admins or Owners to the members of a club. Only members of private clubs can access their announcements. The objects are returned in summary representation.

Parameters

id: integer required

Returns an array of club announcement summary representations.

Definition

GET https://www.strava.com/api/v3/clubs/:id/announcements

Example request

$ curl -G https://www.strava.com/api/v3/clubs/1/announcements \
    -H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"

Example responses

[
  {
    "id": 1219827,
    "resource_state": 2,
    "club_id": 109984,
    "athlete": {
      "id": 227615,
      "resource_state": 2,
      "firstname": "John",
      "lastname": "Applestrava",
      "profile_medium": "http://pics.com/227615/medium.jpg",
      "profile": "http://pics.com/227615/large.jpg",
      "city": "San Francisco",
      "state": "California",
      "country": "United States",
      "sex": "M",
      "friend": "accepted",
      "follower": "accepted",
      "premium": true,
      "created_at": "2009-08-26T13:42:05Z",
      "updated_at": "2013-01-11T18:51:00Z"
    },
    "created_at": "2015-04-01T21:14:02Z",
    "message": "hello club"
  }
]

 

List athlete clubs

Fetch an array of clubs that the currently authenticated athlete is a member of.

Returns a club summary representation.

Definition

GET https://www.strava.com/api/v3/athlete/clubs

Example request

$ curl -G https://www.strava.com/api/v3/athlete/clubs \
    -H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"

Example responses

[
  {
    "id": 1,
    "resource_state": 2,
    "name": "Team Strava Cycling",
    "profile_medium": "http://pics.com/clubs/1/medium.jpg",
    "profile": "http://pics.com/clubs/1/large.jpg",
    "cover_photo": "http://pics.com/clubs/1/cover/large.jpg",
    "cover_photo_small": "http://pics.com/clubs/1/cover/small.jpg",
    "sport_type": "cycling",
    "city": "San Francisco",
    "state": "California",
    "country": "United States",
    "private": true,
    "member_count": 23,
    "featured": false,
    "verified": false,
    "url": "strava-cycling"
  }
]

 

List club members

Retrieve summary information about members of a specific club. Pagination is supported. Enhanced Privacy Mode is respected, only members of the club can access the full list including members with Enhanced Privacy whom they don’t follow.

Parameters

id: integer required
page: integer optional
per_page: integer optional

Returns an array of athlete summary representations, with members followed by the authenticated athlete on top, and sorted by firstnames.

Definition

GET https://www.strava.com/api/v3/clubs/:id/members

Example request

$ curl -G https://www.strava.com/api/v3/clubs/1/members \
    -H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"

Example responses

[
  {
    "id": 227615,
    "resource_state": 2,
    "firstname": "John",
    "lastname": "Applestrava",
    "profile_medium": "http://pics.com/227615/medium.jpg",
    "profile": "http://pics.com/227615/large.jpg",
    "city": "San Francisco",
    "state": "California",
    "country": "United States",
    "sex": "M",
    "friend": null,
    "follower": null,
    "premium": true,
    "created_at": "2008-01-01T17:44:00Z",
    "updated_at": "2013-09-04T20:00:50Z"
  }
]

 

List club admins

Retrieve summary information about admins of a specific club, with the owner on top and sorted by first names. Pagination is supported.

Parameters

id: integer required
page: integer optional
per_page: integer optional

Returns an array of athlete summary representations.

Definition

GET https://www.strava.com/api/v3/clubs/:id/admins

Example request

$ curl -G https://www.strava.com/api/v3/clubs/1/admins \
    -H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"

 

List club activities

Retrieve the recent activities performed by members of a specific club. The authenticated athlete must be a member of the club. Pagination is supported. However, the results are limited to the last 200 total activities by club members.

Parameters

id: integer required
before: integer optional
seconds since UNIX epoch, result will start with activities whose start_date is before this value
page: integer optional
per_page: integer optional

before and page can not be used in combination. They are independent ways of indicating where in the list of activities to begin the results.

Returns an array of activity summary representations.

Definition

GET https://www.strava.com/api/v3/clubs/:id/activities

Example request

$ curl -G https://www.strava.com/api/v3/clubs/1/activities \
    -H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"

Example responses

[
  {
    "id": 80327326,
    "resource_state": 2,
    "guid": "2013-09-05-10-56-52.fit",
    "external_id": "2013-09-05-10-56-52.fit",
    "upload_id": 87467289,
    "athlete": {
      "id": 227615,
      "resource_state": 2,
      "firstname": "John",
      "lastname": "Applestrava",
      "profile_medium": "http://pics.com/227615/medium.jpg",
      "profile": "http://pics.com/227615/large.jpg",
      "city": "San Francisco",
      "state": "CA",
      "country": "United States",
      "sex": "M",
      "friend": null,
      "follower": "accepted",
      "premium": true,
      "created_at": "2011-03-19T21:59:57Z",
      "updated_at": "2013-09-05T16:46:54Z"
    },
    "name": "Commute PR - 11minutes flat",
    "distance": 4509.9,
    "moving_time": 661,
    "elapsed_time": 866,
    "total_elevation_gain": 4.0,
    "type": "Ride",
    "start_date": "2013-09-05T17:56:52Z",
    "start_date_local": "2013-09-05T10:56:52Z",
    "timezone": "(GMT-08:00) America/Los_Angeles",
    "start_latlng": [
      37.783718,
      -122.444316
    ],
    "end_latlng": [
      37.78078,
      -122.396222
    ],
    "location_city": "San Francisco",
    "location_state": "CA",
    "location_country": "United States",
    "achievement_count": 0,
    "kudos_count": 2,
    "comment_count": 2,
    "athlete_count": 1,
    "photo_count": 0,
    "map": {
      "id": "a80327326",
      "summary_polyline": "e{reFzkgjV`e@wg^{^{h@jMkR_IwL",
      "resource_state": 2
    },
    "trainer": false,
    "commute": true,
    "manual": false,
    "private": false,
    "flagged": false,
    "average_watts": 127.06,
    "kilojoules": 83.98666,
    "has_kudoed": false
  }
]

 

Join a club

Join a club on behalf of the authenticated athlete. If the club is private the join will need to be approved by a club admin unless the authenticated athlete had previously been invited to the club. An access token with write permissions is required.

Parameters

id: integer required
ID of the club to join

Definition

POST https://www.strava.com/api/v3/clubs/:id/join

Example responses

{
  "success": true,
  "active": true,
  "membership": "member"
}


private club

{
  "success": true,
  "active": false,
  "membership": "pending"
}

 

Leave a club

Leave a club on behalf of the authenticated user. An access token with write permissions is required.

Parameters

id: integer required
ID of the club to leave

Definition

POST https://www.strava.com/api/v3/clubs/:id/leave

Example response

{
  "success": true,
  "active": false
}