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. Possible values: 2 -> ‘summary’, 3 -> ‘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
deprecated, always false
verified: boolean
owner_id: integer
athlete id of the club owner
following_count: integer
total number of members the authenticated user is currently following
url string
vanity club URL slug

Plus Membership Fields for the requesting athlete.

Club Membership Fields  

membership: string
membership status of the relevant athlete
"member", "pending", null (not a member and have not requested join)
admin: boolean
true only if the relevant athlete is a club admin
owner: boolean
true only if the relevant athlete is the club owner

Summary representation attributes  

id: integer
resource_state: integer
indicates level of detail. Possible values: 2 -> ‘summary’, 3 -> ‘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
deprecated, always false
verified: boolean
url string
vanity club URL slug

Meta representation attributes  

id: integer
resource_state: integer
indicates level of detail. Possible values: 2 -> ‘summary’, 3 -> ‘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,
  "owner_id": 227615,
  "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 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 that include the athlete’s membership status within the given club via membership fields, with members followed by the authenticated athlete on top, and sorted by first names.

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",
    "membership": "member",
    "admin": true,
    "owner": false
  }
]

 

Approve a club member

Approve an athlete as a member of the club. Only applies if the club is private and the athlete has requested membership. The authenticated athlete must be an admin of the club. An access token with write permissions is required.

Parameters

club_id: integer required
athlete_id: integer required

Definition

PUT https://www.strava.com/api/v3/clubs/:club_id/members/:athlete_id

 

Decline a club member

Declines an athlete request for membership. Only applies if the club is private and the athlete has requested membership. The authenticated athlete must be an admin of the club. An access token with write permissions is required.

Parameters

club_id: integer required
athlete_id: integer required

Definition

DELETE https://www.strava.com/api/v3/clubs/:club_id/members/:athlete_id

 

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"

 

Promote to admin

Promote a member to admin. The athlete must already be a member of the club. The authenticated athlete must be an admin of the club. An access token with write permissions is required.

Parameters

club_id: integer required
athlete_id: integer required

Definition

PUT https://www.strava.com/api/v3/clubs/:club_id/admins/:athlete_id

 

Revoke a club admin

Revokes an admin’s rights as admin, leaving them as a normal member of the club. The owner of a club cannot be removed from the admins. The authenticated athlete must be an admin of the club. An access token with write permissions is required.

Parameters

club_id: integer required
athlete_id: integer required

Definition

DELETE https://www.strava.com/api/v3/clubs/:club_id/admins/:athlete_id

 

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
}