Strava API v3

Activities

Delete Activity (deleteActivityById)

Deletes an activity for a given identifier

delete
/activities/{id}

Parameters

id
required Integer, in path
The identifier of the activity.

Responses

HTTP code 204 No content
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http delete "https://www.strava.com/api/v3/activities/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer id = 56; // Integer | The identifier of the activity.

    apiInstance.deleteActivityById(id);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the activity.

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// Delete Activity
[apiInstance deleteActivityByIdWith:id
              completionHandler: ^(NSError* error) {
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var id = 56; // {Integer} The identifier of the activity.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully.');
  }
};
api.deleteActivityById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class deleteActivityByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var id = 56;  // Integer | The identifier of the activity.

            try
            {
                // Delete Activity
                apiInstance.deleteActivityById(id);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.deleteActivityById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
id = 56 # Integer | The identifier of the activity.

try: 
    # Delete Activity
    api_instance.deleteActivityById(id)
except ApiException as e:
    print("Exception when calling ActivitiesApi->deleteActivityById: %s\n" % e)

Get Activity (getActivityById)

Returns an activity for a given identifier.

get
/activities/{id}

Parameters

id
required Integer, in path
The identifier of the activity.
include_all_efforts
Boolean, in query
Whether all segments efforts should be included in the response

Responses

HTTP code 200 The activity's detailed representation An instance of DetailedActivity.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/activities/{id}?include_all_efforts=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer id = 56; // Integer | The identifier of the activity.
    Boolean includeAllEfforts = true; // Boolean | Whether all segments efforts should be included in the response

    Observable<DetailedActivity> result = apiInstance.getActivityById(id, includeAllEfforts);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the activity.
Boolean *includeAllEfforts = true; // Whether all segments efforts should be included in the response (optional)

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// Get Activity
[apiInstance getActivityByIdWith:id
    includeAllEfforts:includeAllEfforts
              completionHandler: ^(STRVDetailedActivity output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var id = 56; // {Integer} The identifier of the activity.

var opts = { 
  'includeAllEfforts': true // {Boolean} Whether all segments efforts should be included in the response
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getActivityById(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getActivityByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var id = 56;  // Integer | The identifier of the activity.
            var includeAllEfforts = true;  // Boolean | Whether all segments efforts should be included in the response (optional) 

            try
            {
                // Get Activity
                DetailedActivity result = apiInstance.getActivityById(id, includeAllEfforts);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.getActivityById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
id = 56 # Integer | The identifier of the activity.
includeAllEfforts = true # Boolean | Whether all segments efforts should be included in the response (optional)

try: 
    # Get Activity
    api_response = api_instance.getActivityById(id, includeAllEfforts=includeAllEfforts)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->getActivityById: %s\n" % e)

Sample Response

""

List Activity Comments (getCommentsByActivityId)

Returns the comments of an activity identified by an identifier.

get
/activities/{id}/comments

Parameters

id
required Integer, in path
The identifier of the activity.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of Comment objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/activities/{id}/comments?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer id = 56; // Integer | The identifier of the activity.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<Comment>> result = apiInstance.getCommentsByActivityId(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the activity.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// List Activity Comments
[apiInstance getCommentsByActivityIdWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVComment>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var id = 56; // {Integer} The identifier of the activity.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getCommentsByActivityId(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getCommentsByActivityIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var id = 56;  // Integer | The identifier of the activity.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Activity Comments
                array[Comment] result = apiInstance.getCommentsByActivityId(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.getCommentsByActivityId: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
id = 56 # Integer | The identifier of the activity.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Activity Comments
    api_response = api_instance.getCommentsByActivityId(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->getCommentsByActivityId: %s\n" % e)

Sample Response

[ {
  "athlete" : "",
  "activity_id" : 123,
  "created_at" : "2000-01-23T04:56:07.000+00:00",
  "id" : 123,
  "text" : "aeiou"
} ]

List Activity Kudoers (getKudoersByActivityId)

Returns the athletes who kudoed an activity identified by an identifier.

get
/activities/{id}/kudos

Parameters

id
required Integer, in path
The identifier of the activity.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryAthlete objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/activities/{id}/kudos?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer id = 56; // Integer | The identifier of the activity.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryAthlete>> result = apiInstance.getKudoersByActivityId(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the activity.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// List Activity Kudoers
[apiInstance getKudoersByActivityIdWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryAthlete>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var id = 56; // {Integer} The identifier of the activity.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getKudoersByActivityId(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getKudoersByActivityIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var id = 56;  // Integer | The identifier of the activity.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Activity Kudoers
                array[SummaryAthlete] result = apiInstance.getKudoersByActivityId(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.getKudoersByActivityId: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
id = 56 # Integer | The identifier of the activity.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Activity Kudoers
    api_response = api_instance.getKudoersByActivityId(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->getKudoersByActivityId: %s\n" % e)

Sample Response

[ "" ]

List Activity Laps (getLapsByActivityId)

Returns the laps of an activity identified by an identifier.

get
/activities/{id}/laps

Parameters

id
required Integer, in path
The identifier of the activity.

Responses

HTTP code 200 An array of Lap objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/activities/{id}/laps" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer id = 56; // Integer | The identifier of the activity.

    Observable<List<Lap>> result = apiInstance.getLapsByActivityId(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the activity.

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// List Activity Laps
[apiInstance getLapsByActivityIdWith:id
              completionHandler: ^(NSArray<STRVLap>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var id = 56; // {Integer} The identifier of the activity.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLapsByActivityId(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLapsByActivityIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var id = 56;  // Integer | The identifier of the activity.

            try
            {
                // List Activity Laps
                array[Lap] result = apiInstance.getLapsByActivityId(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.getLapsByActivityId: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
id = 56 # Integer | The identifier of the activity.

try: 
    # List Activity Laps
    api_response = api_instance.getLapsByActivityId(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->getLapsByActivityId: %s\n" % e)

Sample Response

[ {
  "pace_zone" : 123,
  "average_cadence" : 1.3579000000000001069366817318950779736042022705078125,
  "activity" : {
    "id" : 123
  },
  "distance" : 1.3579000000000001069366817318950779736042022705078125,
  "athlete" : {
    "id" : 123
  },
  "start_date_local" : "2000-01-23T04:56:07.000+00:00",
  "end_index" : 123,
  "max_speed" : 1.3579000000000001069366817318950779736042022705078125,
  "lap_index" : 123,
  "total_elevation_gain" : 1.3579000000000001069366817318950779736042022705078125,
  "split" : 123,
  "start_index" : 123,
  "elapsed_time" : 123,
  "name" : "aeiou",
  "id" : 123456789,
  "average_speed" : 1.3579000000000001069366817318950779736042022705078125,
  "moving_time" : 123,
  "start_date" : "2000-01-23T04:56:07.000+00:00"
} ]

List Athlete Activities (getLoggedInAthleteActivities)

Returns the activities of an athlete for a specific identifier.

get
/athlete/activities

Parameters

before
Integer, in query
An epoch timestamp to use for filtering activities that have taken place before a certain time
after
Integer, in query
An epoch timestamp to use for filtering activities that have taken place after a certain time
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryActivity objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athlete/activities?before=&after=&page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer before = 56; // Integer | An epoch timestamp to use for filtering activities that have taken place before a certain time
    Integer after = 56; // Integer | An epoch timestamp to use for filtering activities that have taken place after a certain time
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryActivity>> result = apiInstance.getLoggedInAthleteActivities(before, after, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *before = 56; // An epoch timestamp to use for filtering activities that have taken place before a certain time (optional)
Integer *after = 56; // An epoch timestamp to use for filtering activities that have taken place after a certain time (optional)
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// List Athlete Activities
[apiInstance getLoggedInAthleteActivitiesWith:before
    after:after
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryActivity>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var opts = { 
  'before': 56, // {Integer} An epoch timestamp to use for filtering activities that have taken place before a certain time
  'after': 56, // {Integer} An epoch timestamp to use for filtering activities that have taken place after a certain time
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLoggedInAthleteActivities(opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLoggedInAthleteActivitiesExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var before = 56;  // Integer | An epoch timestamp to use for filtering activities that have taken place before a certain time (optional) 
            var after = 56;  // Integer | An epoch timestamp to use for filtering activities that have taken place after a certain time (optional) 
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Athlete Activities
                array[SummaryActivity] result = apiInstance.getLoggedInAthleteActivities(before, after, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.getLoggedInAthleteActivities: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
before = 56 # Integer | An epoch timestamp to use for filtering activities that have taken place before a certain time (optional)
after = 56 # Integer | An epoch timestamp to use for filtering activities that have taken place after a certain time (optional)
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Athlete Activities
    api_response = api_instance.getLoggedInAthleteActivities(before=before, after=after, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->getLoggedInAthleteActivities: %s\n" % e)

Sample Response

[ {
  "id" : 999582172,
  "resource_state" : 2,
  "external_id" : "garmin_push_1747504801",
  "upload_id" : 1101802971,
  "athlete" : {
    "id" : 136697,
    "resource_state" : 1
  },
  "name" : "Jonathan Pon Memorial Ride 2017 Day 2",
  "distance" : 122111,
  "moving_time" : 18748,
  "elapsed_time" : 25880,
  "total_elevation_gain" : 1055,
  "type" : "Ride",
  "start_date" : "2017-05-21T13:35:33Z",
  "start_date_local" : "2017-05-21T06:35:33Z",
  "timezone" : "(GMT-08:00) America/Los_Angeles",
  "utc_offset" : -25200,
  "start_latlng" : [ 38.46, -123.05 ],
  "end_latlng" : [ 37.87, -122.5 ],
  "location_city" : null,
  "location_state" : null,
  "location_country" : "United States",
  "start_latitude" : 38.46,
  "start_longitude" : -123.05,
  "achievement_count" : 22,
  "kudos_count" : 35,
  "comment_count" : 0,
  "athlete_count" : 3,
  "photo_count" : 0,
  "map" : {
    "id" : "a999582172",
    "summary_polyline" : "}_wiFh{_nVxJaDiBmKbc@`RpEda@pb@~b@v_@xiAcF|l@gb@j`ABrg@~KfNxh@zLrPpSr`@yTvDjr@f`B_q@`@wMlJnC|h@sU`^wBdHaMx]d@lHuLcCcLxLq@nKoUlnA_]hDyIhi@mVf@wH|tAgd@zi@qn@vQee@rZoPvJgVjQtGrIsNnDxS~UsKpqAecBmFwn@bAun@wb@e\\wMiWcFcp@sOmUcX}N}Lya@qBsn@bCg[lOeQjj@uwBzMwuCvc@yM~HwYgVsc@kA}a@jp@{kCJqcC`Okm@pCqz@v|@_hCnYqaBlQ_g@fe@y_@b{@kEzo@cPzfAsdBhAw~AuDeg@{J}l@gYku@wCgd@xK{kB|vAq|Chq@yiBrc@sp@bFaqC~Xam@{IcHhMsc@p_@bRvMeB~cBw`AtT_Vfu@hu@~}@nd@nCsvBrLi}@mB}J``@y{@~oBmuCxqAa[fpAgDhdBnSz_ArTpJbM|zAin@xR_VxQzKrS`^fIp@bNmExa@uf@fEi`B`^{}@na@q]ta@FndA`c@~c@^`Nj]?jMlsAtl@bLiN`v@m@vRkZvQhJzGkGu@kOxk@uKvYiiAtt@ki@zZyDtNlCG`Jz^fDny@orAfUkRhSl@nt@rf@rs@fH|EjP`~@RfFcWjMyIn]~LtJqL~QH`WdJXpaAta@hGd|AsPxwAasBdc@m\\eHK",
    "resource_state" : 2
  },
  "trainer" : false,
  "commute" : false,
  "manual" : false,
  "private" : false,
  "flagged" : false,
  "gear_id" : "b3123396",
  "average_speed" : 6.513,
  "max_speed" : 17.3,
  "average_temp" : 26,
  "average_watts" : 132.1,
  "kilojoules" : 2476.6,
  "device_watts" : false,
  "has_heartrate" : false,
  "elev_high" : 79.6,
  "elev_low" : -9.6,
  "pr_count" : 4,
  "total_photo_count" : 0,
  "has_kudoed" : false,
  "workout_type" : 10,
  "suffer_score" : null
} ]

List Friends' Activities (getLoggedInAthleteFriendsActivities)

Returns the activities of the friends of the logged-in athlete.

get
/activities/following

Parameters

before
Integer, in query
An epoch timestamp to use for filtering activities that have taken place before a certain time
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryActivity objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/activities/following?before=&page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer before = 56; // Integer | An epoch timestamp to use for filtering activities that have taken place before a certain time
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryActivity>> result = apiInstance.getLoggedInAthleteFriendsActivities(before, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *before = 56; // An epoch timestamp to use for filtering activities that have taken place before a certain time (optional)
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// List Friends' Activities
[apiInstance getLoggedInAthleteFriendsActivitiesWith:before
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryActivity>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var opts = { 
  'before': 56, // {Integer} An epoch timestamp to use for filtering activities that have taken place before a certain time
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLoggedInAthleteFriendsActivities(opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLoggedInAthleteFriendsActivitiesExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var before = 56;  // Integer | An epoch timestamp to use for filtering activities that have taken place before a certain time (optional) 
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Friends' Activities
                array[SummaryActivity] result = apiInstance.getLoggedInAthleteFriendsActivities(before, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.getLoggedInAthleteFriendsActivities: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
before = 56 # Integer | An epoch timestamp to use for filtering activities that have taken place before a certain time (optional)
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Friends' Activities
    api_response = api_instance.getLoggedInAthleteFriendsActivities(before=before, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->getLoggedInAthleteFriendsActivities: %s\n" % e)

Sample Response

[ "" ]

List Related Activities (getRelatedActivities)

Returns a list of activities related to another using specific identifier.

get
/activities/{id}/related

Parameters

id
required Integer, in path
The unique identifier of the activity.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryActivity objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/activities/{id}/related?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer id = 56; // Integer | The unique identifier of the activity.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryActivity>> result = apiInstance.getRelatedActivities(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The unique identifier of the activity.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// List Related Activities
[apiInstance getRelatedActivitiesWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryActivity>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var id = 56; // {Integer} The unique identifier of the activity.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRelatedActivities(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getRelatedActivitiesExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var id = 56;  // Integer | The unique identifier of the activity.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Related Activities
                array[SummaryActivity] result = apiInstance.getRelatedActivities(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.getRelatedActivities: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
id = 56 # Integer | The unique identifier of the activity.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Related Activities
    api_response = api_instance.getRelatedActivities(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->getRelatedActivities: %s\n" % e)

Sample Response

[ "" ]

Get Activity Zones (getZonesByActivityId)

Returns the zones of an activity identified by an identifier.

get
/activities/{id}/zones

Parameters

id
required Integer, in path
The identifier of the activity.

Responses

HTTP code 200 An array of ActivityZone objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/activities/{id}/zones" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer id = 56; // Integer | The identifier of the activity.

    Observable<List<ActivityZone>> result = apiInstance.getZonesByActivityId(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the activity.

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// Get Activity Zones
[apiInstance getZonesByActivityIdWith:id
              completionHandler: ^(NSArray<STRVActivityZone>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var id = 56; // {Integer} The identifier of the activity.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getZonesByActivityId(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getZonesByActivityIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var id = 56;  // Integer | The identifier of the activity.

            try
            {
                // Get Activity Zones
                array[ActivityZone] result = apiInstance.getZonesByActivityId(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.getZonesByActivityId: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
id = 56 # Integer | The identifier of the activity.

try: 
    # Get Activity Zones
    api_response = api_instance.getZonesByActivityId(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->getZonesByActivityId: %s\n" % e)

Sample Response

[ {
  "score" : 123,
  "sensor_based" : true,
  "custom_zones" : true,
  "max" : 123,
  "distribution_buckets" : "",
  "type" : "aeiou",
  "points" : 123
} ]

Update Activity (updateActivityById)

Updates an activity for a given identifier

put
/activities/{id}

Parameters

id
required Integer, in path
The identifier of the activity.
<Not a named parameter>
UpdatableActivity, in body
An instance of UpdatableActivity.

Responses

HTTP code 200 The activity's detailed representation An instance of DetailedActivity.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http put "https://www.strava.com/api/v3/activities/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ActivitiesApi;

import rx.Observable;

public class ActivitiesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ActivitiesApi api = client.createService(ActivitiesApi.class);

    Integer id = 56; // Integer | The identifier of the activity.
    UpdatableActivity body = ; // UpdatableActivity | 

    Observable<DetailedActivity> result = apiInstance.updateActivityById(id, body);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the activity.
UpdatableActivity *body = ; //  (optional)

STRVActivitiesApi *apiInstance = [[STRVActivitiesApi alloc] init];

// Update Activity
[apiInstance updateActivityByIdWith:id
    body:body
              completionHandler: ^(STRVDetailedActivity output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ActivitiesApi()

var id = 56; // {Integer} The identifier of the activity.

var opts = { 
  'body':  // {UpdatableActivity} 
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateActivityById(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class updateActivityByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ActivitiesApi();
            var id = 56;  // Integer | The identifier of the activity.
            var body = new UpdatableActivity(); // UpdatableActivity |  (optional) 

            try
            {
                // Update Activity
                DetailedActivity result = apiInstance.updateActivityById(id, body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ActivitiesApi.updateActivityById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ActivitiesApi()
id = 56 # Integer | The identifier of the activity.
body =  # UpdatableActivity |  (optional)

try: 
    # Update Activity
    api_response = api_instance.updateActivityById(id, body=body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ActivitiesApi->updateActivityById: %s\n" % e)

Sample Response

""

Athletes

Get Athlete (getAthleteById)

Returns an athlete for a given identifier.

get
/athletes/{id}

Parameters

id
required Integer, in path
The identifier of the athlete.

Responses

HTTP code 200 Profile information for an athlete An instance of DetailedAthlete.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athletes/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);

    Integer id = 56; // Integer | The identifier of the athlete.

    Observable<DetailedAthlete> result = apiInstance.getAthleteById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the athlete.

STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// Get Athlete
[apiInstance getAthleteByIdWith:id
              completionHandler: ^(STRVDetailedAthlete output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var id = 56; // {Integer} The identifier of the athlete.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getAthleteById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getAthleteByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();
            var id = 56;  // Integer | The identifier of the athlete.

            try
            {
                // Get Athlete
                DetailedAthlete result = apiInstance.getAthleteById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getAthleteById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()
id = 56 # Integer | The identifier of the athlete.

try: 
    # Get Athlete
    api_response = api_instance.getAthleteById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getAthleteById: %s\n" % e)

Sample Response

""

List Athlete Followers (getAthleteFollowers)

Returns the list of a given athlete's followers.

get
/athletes/{id}/followers

Parameters

id
required Integer, in path
The identifier of the athlete.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryAthlete objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athletes/{id}/followers?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);

    Integer id = 56; // Integer | The identifier of the athlete.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryAthlete>> result = apiInstance.getAthleteFollowers(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the athlete.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// List Athlete Followers
[apiInstance getAthleteFollowersWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryAthlete>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var id = 56; // {Integer} The identifier of the athlete.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getAthleteFollowers(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getAthleteFollowersExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();
            var id = 56;  // Integer | The identifier of the athlete.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Athlete Followers
                array[SummaryAthlete] result = apiInstance.getAthleteFollowers(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getAthleteFollowers: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()
id = 56 # Integer | The identifier of the athlete.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Athlete Followers
    api_response = api_instance.getAthleteFollowers(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getAthleteFollowers: %s\n" % e)

Sample Response

[ "" ]

List Athlete Friends (getAthleteFriends)

Returns a given athlete's friends.

get
/athletes/{id}/friends

Parameters

id
required Integer, in path
The identifier of the athlete.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryAthlete objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athletes/{id}/friends?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);

    Integer id = 56; // Integer | The identifier of the athlete.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryAthlete>> result = apiInstance.getAthleteFriends(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the athlete.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// List Athlete Friends
[apiInstance getAthleteFriendsWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryAthlete>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var id = 56; // {Integer} The identifier of the athlete.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getAthleteFriends(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getAthleteFriendsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();
            var id = 56;  // Integer | The identifier of the athlete.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Athlete Friends
                array[SummaryAthlete] result = apiInstance.getAthleteFriends(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getAthleteFriends: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()
id = 56 # Integer | The identifier of the athlete.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Athlete Friends
    api_response = api_instance.getAthleteFriends(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getAthleteFriends: %s\n" % e)

Sample Response

[ "" ]

List Common Friends (getCommonFriends)

Returns a list of the common friends between a given athlete and the logged-in athlete.

get
/athletes/{id}/both-following

Parameters

id
required Integer, in path
The identifier of the athlete.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryAthlete objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athletes/{id}/both-following?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);

    Integer id = 56; // Integer | The identifier of the athlete.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryAthlete>> result = apiInstance.getCommonFriends(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the athlete.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// List Common Friends
[apiInstance getCommonFriendsWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryAthlete>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var id = 56; // {Integer} The identifier of the athlete.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getCommonFriends(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getCommonFriendsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();
            var id = 56;  // Integer | The identifier of the athlete.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Common Friends
                array[SummaryAthlete] result = apiInstance.getCommonFriends(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getCommonFriends: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()
id = 56 # Integer | The identifier of the athlete.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Common Friends
    api_response = api_instance.getCommonFriends(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getCommonFriends: %s\n" % e)

Sample Response

[ "" ]

Get Logged-in Athlete (getLoggedInAthlete)

Returns the currently logged-in athlete

get
/athlete

Responses

HTTP code 200 Profile information for the logged-in athlete An instance of DetailedAthlete.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athlete" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);


    Observable<DetailedAthlete> result = apiInstance.getLoggedInAthlete();
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];


STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// Get Logged-in Athlete
[apiInstance getLoggedInAthleteWithCompletionHandler: 
              ^(STRVDetailedAthlete output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLoggedInAthlete(callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLoggedInAthleteExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();

            try
            {
                // Get Logged-in Athlete
                DetailedAthlete result = apiInstance.getLoggedInAthlete();
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getLoggedInAthlete: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()

try: 
    # Get Logged-in Athlete
    api_response = api_instance.getLoggedInAthlete()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getLoggedInAthlete: %s\n" % e)

Sample Response

""

List Followers (getLoggedInAthleteFollowers)

Returns a list of the logged-in athlete's followers.

get
/athlete/followers

Parameters

page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryAthlete objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athlete/followers?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);

    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryAthlete>> result = apiInstance.getLoggedInAthleteFollowers(page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// List Followers
[apiInstance getLoggedInAthleteFollowersWith:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryAthlete>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLoggedInAthleteFollowers(opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLoggedInAthleteFollowersExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Followers
                array[SummaryAthlete] result = apiInstance.getLoggedInAthleteFollowers(page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getLoggedInAthleteFollowers: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Followers
    api_response = api_instance.getLoggedInAthleteFollowers(page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getLoggedInAthleteFollowers: %s\n" % e)

Sample Response

[ "" ]

List Friends (getLoggedInAthleteFriends)

Returns a list of logged-in athlete's friends, i.e. athletes followed by the logged-in athlete.

get
/athlete/friends

Parameters

page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryAthlete objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athlete/friends?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);

    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryAthlete>> result = apiInstance.getLoggedInAthleteFriends(page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// List Friends
[apiInstance getLoggedInAthleteFriendsWith:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryAthlete>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLoggedInAthleteFriends(opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLoggedInAthleteFriendsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Friends
                array[SummaryAthlete] result = apiInstance.getLoggedInAthleteFriends(page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getLoggedInAthleteFriends: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Friends
    api_response = api_instance.getLoggedInAthleteFriends(page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getLoggedInAthleteFriends: %s\n" % e)

Sample Response

[ "" ]

Get Zones (getLoggedInAthleteZones)

Returns the the logged-in athlete's heart rate and power zones.

get
/athlete/zones

Responses

HTTP code 200 Heart rate and power zones An instance of Zones.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athlete/zones" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);


    Observable<Zones> result = apiInstance.getLoggedInAthleteZones();
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];


STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// Get Zones
[apiInstance getLoggedInAthleteZonesWithCompletionHandler: 
              ^(STRVZones output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLoggedInAthleteZones(callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLoggedInAthleteZonesExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();

            try
            {
                // Get Zones
                Zones result = apiInstance.getLoggedInAthleteZones();
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getLoggedInAthleteZones: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()

try: 
    # Get Zones
    api_response = api_instance.getLoggedInAthleteZones()
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getLoggedInAthleteZones: %s\n" % e)

Sample Response

{
  "heart_rate" : {
    "custom_zones" : true,
    "zones" : ""
  },
  "power" : {
    "zones" : ""
  }
}

Get Athlete Stats (getStats)

Returns the activity stats of an athlete.

get
/athletes/{id}/stats

Parameters

id
required Integer, in path
The identifier of the athlete.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 Activity stats of the athlete An instance of ActivityStats.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athletes/{id}/stats?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);

    Integer id = 56; // Integer | The identifier of the athlete.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<ActivityStats> result = apiInstance.getStats(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the athlete.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// Get Athlete Stats
[apiInstance getStatsWith:id
    page:page
    perPage:perPage
              completionHandler: ^(STRVActivityStats output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var id = 56; // {Integer} The identifier of the athlete.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getStats(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getStatsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();
            var id = 56;  // Integer | The identifier of the athlete.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // Get Athlete Stats
                ActivityStats result = apiInstance.getStats(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.getStats: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()
id = 56 # Integer | The identifier of the athlete.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # Get Athlete Stats
    api_response = api_instance.getStats(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->getStats: %s\n" % e)

Sample Response

{
  "recent_run_totals" : "",
  "all_run_totals" : "",
  "recent_swim_totals" : "",
  "biggest_ride_distance" : 1.3579000000000001069366817318950779736042022705078125,
  "ytd_swim_totals" : "",
  "all_swim_totals" : "",
  "recent_ride_totals" : {
    "distance" : 1.3579000000000001069366817318950779736042022705078125,
    "achievement_count" : 123,
    "count" : 123,
    "elapsed_time" : 123,
    "elevation_gain" : 1.3579000000000001069366817318950779736042022705078125,
    "moving_time" : 123
  },
  "biggest_climb_elevation_gain" : 1.3579000000000001069366817318950779736042022705078125,
  "ytd_ride_totals" : "",
  "all_ride_totals" : "",
  "ytd_run_totals" : ""
}

Update Athlete (updateLoggedInAthlete)

Update the currently logged-in athlete

put
/athlete

Parameters

<Not a named parameter>
required DetailedAthlete, in body
An instance of DetailedAthlete.

Responses

HTTP code 200 Profile information for the logged-in athlete An instance of DetailedAthlete.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http put "https://www.strava.com/api/v3/athlete" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.AthletesApi;

import rx.Observable;

public class AthletesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    AthletesApi api = client.createService(AthletesApi.class);

    DetailedAthlete body = ; // DetailedAthlete | The athlete entity to update

    Observable<DetailedAthlete> result = apiInstance.updateLoggedInAthlete(body);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

DetailedAthlete *body = ; // The athlete entity to update

STRVAthletesApi *apiInstance = [[STRVAthletesApi alloc] init];

// Update Athlete
[apiInstance updateLoggedInAthleteWith:body
              completionHandler: ^(STRVDetailedAthlete output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.AthletesApi()

var body = ; // {DetailedAthlete} The athlete entity to update


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.updateLoggedInAthlete(body, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class updateLoggedInAthleteExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new AthletesApi();
            var body = new DetailedAthlete(); // DetailedAthlete | The athlete entity to update

            try
            {
                // Update Athlete
                DetailedAthlete result = apiInstance.updateLoggedInAthlete(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling AthletesApi.updateLoggedInAthlete: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.AthletesApi()
body =  # DetailedAthlete | The athlete entity to update

try: 
    # Update Athlete
    api_response = api_instance.updateLoggedInAthlete(body)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling AthletesApi->updateLoggedInAthlete: %s\n" % e)

Sample Response

""

Clubs

List Club Activities (getClubActivitiesById)

Returns a list of the activities of a given club.

get
/clubs/{id}/activities

Parameters

id
required Integer, in path
The identifier of the club.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryActivity objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/clubs/{id}/activities?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ClubsApi;

import rx.Observable;

public class ClubsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ClubsApi api = client.createService(ClubsApi.class);

    Integer id = 56; // Integer | The identifier of the club.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryActivity>> result = apiInstance.getClubActivitiesById(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the club.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVClubsApi *apiInstance = [[STRVClubsApi alloc] init];

// List Club Activities
[apiInstance getClubActivitiesByIdWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryActivity>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ClubsApi()

var id = 56; // {Integer} The identifier of the club.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getClubActivitiesById(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getClubActivitiesByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ClubsApi();
            var id = 56;  // Integer | The identifier of the club.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Club Activities
                array[SummaryActivity] result = apiInstance.getClubActivitiesById(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ClubsApi.getClubActivitiesById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ClubsApi()
id = 56 # Integer | The identifier of the club.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Club Activities
    api_response = api_instance.getClubActivitiesById(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ClubsApi->getClubActivitiesById: %s\n" % e)

Sample Response

[ "" ]

List Club Administrators (getClubAdminsById)

Returns a list of the administrators of a given club.

get
/clubs/{id}/admins

Parameters

id
required Integer, in path
The identifier of the club.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryAthlete objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/clubs/{id}/admins?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ClubsApi;

import rx.Observable;

public class ClubsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ClubsApi api = client.createService(ClubsApi.class);

    Integer id = 56; // Integer | The identifier of the club.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryAthlete>> result = apiInstance.getClubAdminsById(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the club.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVClubsApi *apiInstance = [[STRVClubsApi alloc] init];

// List Club Administrators
[apiInstance getClubAdminsByIdWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryAthlete>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ClubsApi()

var id = 56; // {Integer} The identifier of the club.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getClubAdminsById(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getClubAdminsByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ClubsApi();
            var id = 56;  // Integer | The identifier of the club.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Club Administrators
                array[SummaryAthlete] result = apiInstance.getClubAdminsById(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ClubsApi.getClubAdminsById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ClubsApi()
id = 56 # Integer | The identifier of the club.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Club Administrators
    api_response = api_instance.getClubAdminsById(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ClubsApi->getClubAdminsById: %s\n" % e)

Sample Response

[ "" ]

List Club Announcements (getClubAnnouncementsById)

Returns a list of the announcements of a given club.

get
/clubs/{id}/announcements

Parameters

id
required Integer, in path
The identifier of the club.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of ClubAnnouncement objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/clubs/{id}/announcements?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ClubsApi;

import rx.Observable;

public class ClubsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ClubsApi api = client.createService(ClubsApi.class);

    Integer id = 56; // Integer | The identifier of the club.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<ClubAnnouncement>> result = apiInstance.getClubAnnouncementsById(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the club.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVClubsApi *apiInstance = [[STRVClubsApi alloc] init];

// List Club Announcements
[apiInstance getClubAnnouncementsByIdWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVClubAnnouncement>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ClubsApi()

var id = 56; // {Integer} The identifier of the club.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getClubAnnouncementsById(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getClubAnnouncementsByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ClubsApi();
            var id = 56;  // Integer | The identifier of the club.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Club Announcements
                array[ClubAnnouncement] result = apiInstance.getClubAnnouncementsById(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ClubsApi.getClubAnnouncementsById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ClubsApi()
id = 56 # Integer | The identifier of the club.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Club Announcements
    api_response = api_instance.getClubAnnouncementsById(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ClubsApi->getClubAnnouncementsById: %s\n" % e)

Sample Response

[ {
  "athlete" : "",
  "club_id" : 123,
  "created_at" : "2000-01-23T04:56:07.000+00:00",
  "id" : 123,
  "message" : "aeiou"
} ]

Get Club (getClubById)

Returns a given club using its identifier.

get
/clubs/{id}

Parameters

id
required Integer, in path
The identifier of the club.

Responses

HTTP code 200 The detailed representation of a club An instance of DetailedClub.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/clubs/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ClubsApi;

import rx.Observable;

public class ClubsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ClubsApi api = client.createService(ClubsApi.class);

    Integer id = 56; // Integer | The identifier of the club.

    Observable<DetailedClub> result = apiInstance.getClubById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the club.

STRVClubsApi *apiInstance = [[STRVClubsApi alloc] init];

// Get Club
[apiInstance getClubByIdWith:id
              completionHandler: ^(STRVDetailedClub output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ClubsApi()

var id = 56; // {Integer} The identifier of the club.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getClubById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getClubByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ClubsApi();
            var id = 56;  // Integer | The identifier of the club.

            try
            {
                // Get Club
                DetailedClub result = apiInstance.getClubById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ClubsApi.getClubById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ClubsApi()
id = 56 # Integer | The identifier of the club.

try: 
    # Get Club
    api_response = api_instance.getClubById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ClubsApi->getClubById: %s\n" % e)

Sample Response

""

List Club Members (getClubMembersById)

Returns a list of the athletes who are members of a given club.

get
/clubs/{id}/members

Parameters

id
required Integer, in path
The identifier of the club.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryAthlete objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/clubs/{id}/members?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ClubsApi;

import rx.Observable;

public class ClubsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ClubsApi api = client.createService(ClubsApi.class);

    Integer id = 56; // Integer | The identifier of the club.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryAthlete>> result = apiInstance.getClubMembersById(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the club.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVClubsApi *apiInstance = [[STRVClubsApi alloc] init];

// List Club Members
[apiInstance getClubMembersByIdWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryAthlete>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ClubsApi()

var id = 56; // {Integer} The identifier of the club.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getClubMembersById(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getClubMembersByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ClubsApi();
            var id = 56;  // Integer | The identifier of the club.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Club Members
                array[SummaryAthlete] result = apiInstance.getClubMembersById(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ClubsApi.getClubMembersById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ClubsApi()
id = 56 # Integer | The identifier of the club.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Club Members
    api_response = api_instance.getClubMembersById(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ClubsApi->getClubMembersById: %s\n" % e)

Sample Response

[ "" ]

List Athlete Clubs (getLoggedInAthleteClubs)

Returns a list of the clubs whose membership includes the logged-in athlete.

get
/athlete/clubs

Parameters

page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummaryClub objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athlete/clubs?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ClubsApi;

import rx.Observable;

public class ClubsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ClubsApi api = client.createService(ClubsApi.class);

    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummaryClub>> result = apiInstance.getLoggedInAthleteClubs(page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVClubsApi *apiInstance = [[STRVClubsApi alloc] init];

// List Athlete Clubs
[apiInstance getLoggedInAthleteClubsWith:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummaryClub>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ClubsApi()

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLoggedInAthleteClubs(opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLoggedInAthleteClubsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ClubsApi();
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Athlete Clubs
                array[SummaryClub] result = apiInstance.getLoggedInAthleteClubs(page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ClubsApi.getLoggedInAthleteClubs: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ClubsApi()
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Athlete Clubs
    api_response = api_instance.getLoggedInAthleteClubs(page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ClubsApi->getLoggedInAthleteClubs: %s\n" % e)

Sample Response

[ "" ]

Join Club (joinClubById)

Adds the logged-in athlete to the club's membership.

post
/clubs/{id}/join

Parameters

id
required Integer, in path
The identifier of the club.

Responses

HTTP code 200 A representation of the athlete's membership in the club An instance of MembershipApplication.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http post "https://www.strava.com/api/v3/clubs/{id}/join" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ClubsApi;

import rx.Observable;

public class ClubsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ClubsApi api = client.createService(ClubsApi.class);

    Integer id = 56; // Integer | The identifier of the club.

    Observable<MembershipApplication> result = apiInstance.joinClubById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the club.

STRVClubsApi *apiInstance = [[STRVClubsApi alloc] init];

// Join Club
[apiInstance joinClubByIdWith:id
              completionHandler: ^(STRVMembershipApplication output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ClubsApi()

var id = 56; // {Integer} The identifier of the club.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.joinClubById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class joinClubByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ClubsApi();
            var id = 56;  // Integer | The identifier of the club.

            try
            {
                // Join Club
                MembershipApplication result = apiInstance.joinClubById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ClubsApi.joinClubById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ClubsApi()
id = 56 # Integer | The identifier of the club.

try: 
    # Join Club
    api_response = api_instance.joinClubById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ClubsApi->joinClubById: %s\n" % e)

Sample Response

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

Leave Club (leaveClubById)

Removes the logged-in athlete from the club's membership.

post
/clubs/{id}/leave

Parameters

id
required Integer, in path
The identifier of the club.

Responses

HTTP code 200 A representation of the athlete's membership in the club An instance of MembershipApplication.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http post "https://www.strava.com/api/v3/clubs/{id}/leave" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.ClubsApi;

import rx.Observable;

public class ClubsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    ClubsApi api = client.createService(ClubsApi.class);

    Integer id = 56; // Integer | The identifier of the club.

    Observable<MembershipApplication> result = apiInstance.leaveClubById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the club.

STRVClubsApi *apiInstance = [[STRVClubsApi alloc] init];

// Leave Club
[apiInstance leaveClubByIdWith:id
              completionHandler: ^(STRVMembershipApplication output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.ClubsApi()

var id = 56; // {Integer} The identifier of the club.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.leaveClubById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class leaveClubByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new ClubsApi();
            var id = 56;  // Integer | The identifier of the club.

            try
            {
                // Leave Club
                MembershipApplication result = apiInstance.leaveClubById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ClubsApi.leaveClubById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.ClubsApi()
id = 56 # Integer | The identifier of the club.

try: 
    # Leave Club
    api_response = api_instance.leaveClubById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ClubsApi->leaveClubById: %s\n" % e)

Sample Response

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

Gears

Get Equipment (getGearById)

Returns an equipment using its identifier.

get
/gear/{id}

Parameters

id
required Integer, in path
The identifier of the gear.

Responses

HTTP code 200 A representation of the gear An instance of DetailedGear.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/gear/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.GearsApi;

import rx.Observable;

public class GearsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    GearsApi api = client.createService(GearsApi.class);

    Integer id = 56; // Integer | The identifier of the gear.

    Observable<DetailedGear> result = apiInstance.getGearById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the gear.

STRVGearsApi *apiInstance = [[STRVGearsApi alloc] init];

// Get Equipment
[apiInstance getGearByIdWith:id
              completionHandler: ^(STRVDetailedGear output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.GearsApi()

var id = 56; // {Integer} The identifier of the gear.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getGearById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getGearByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new GearsApi();
            var id = 56;  // Integer | The identifier of the gear.

            try
            {
                // Get Equipment
                DetailedGear result = apiInstance.getGearById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GearsApi.getGearById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.GearsApi()
id = 56 # Integer | The identifier of the gear.

try: 
    # Get Equipment
    api_response = api_instance.getGearById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GearsApi->getGearById: %s\n" % e)

Sample Response

""

Routes

Get Route (getRouteById)

Returns a route using its identifier.

get
/routes/{id}

Parameters

id
required Integer, in path
The identifier of the route.

Responses

HTTP code 200 A representation of the route An instance of Route.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/routes/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.RoutesApi;

import rx.Observable;

public class RoutesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    RoutesApi api = client.createService(RoutesApi.class);

    Integer id = 56; // Integer | The identifier of the route.

    Observable<Route> result = apiInstance.getRouteById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the route.

STRVRoutesApi *apiInstance = [[STRVRoutesApi alloc] init];

// Get Route
[apiInstance getRouteByIdWith:id
              completionHandler: ^(STRVRoute output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.RoutesApi()

var id = 56; // {Integer} The identifier of the route.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRouteById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getRouteByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new RoutesApi();
            var id = 56;  // Integer | The identifier of the route.

            try
            {
                // Get Route
                Route result = apiInstance.getRouteById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RoutesApi.getRouteById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.RoutesApi()
id = 56 # Integer | The identifier of the route.

try: 
    # Get Route
    api_response = api_instance.getRouteById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RoutesApi->getRouteById: %s\n" % e)

Sample Response

{
  "private" : true,
  "distance" : 1.3579000000000001069366817318950779736042022705078125,
  "athlete" : "",
  "description" : "aeiou",
  "elevation_gain" : 1.3579000000000001069366817318950779736042022705078125,
  "type" : 123,
  "segments" : [ {
    "country" : "aeiou",
    "private" : true,
    "distance" : 1.3579000000000001069366817318950779736042022705078125,
    "average_grade" : 1.3579000000000001069366817318950779736042022705078125,
    "maximum_grade" : 1.3579000000000001069366817318950779736042022705078125,
    "climb_category" : 123,
    "city" : "aeiou",
    "elevation_high" : 1.3579000000000001069366817318950779736042022705078125,
    "athlete_pr_effort" : {
      "distance" : 1.3579000000000001069366817318950779736042022705078125,
      "start_date_local" : "2000-01-23T04:56:07.000+00:00",
      "elapsed_time" : 123,
      "is_kom" : true,
      "id" : 123456789,
      "start_date" : "2000-01-23T04:56:07.000+00:00"
    },
    "start_latlng" : "",
    "elevation_low" : 1.3579000000000001069366817318950779736042022705078125,
    "end_latlng" : "",
    "activity_type" : "aeiou",
    "name" : "aeiou",
    "id" : 123,
    "state" : "aeiou"
  } ],
  "starred" : true,
  "directions" : [ "" ],
  "sub_type" : 123,
  "name" : "aeiou",
  "id" : 123,
  "map" : {
    "summary_polyline" : "aeiou",
    "id" : "aeiou",
    "polyline" : "aeiou"
  },
  "timestamp" : 123
}

List Athlete Routes (getRoutesByAthleteId)

Returns a list of the routes created by an athlete using their identifier.

get
/athletes/{id}/routes

Parameters

id
required Integer, in path
The identifier of the athlete.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of Route objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/athletes/{id}/routes?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.RoutesApi;

import rx.Observable;

public class RoutesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    RoutesApi api = client.createService(RoutesApi.class);

    Integer id = 56; // Integer | The identifier of the athlete.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<Route>> result = apiInstance.getRoutesByAthleteId(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the athlete.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVRoutesApi *apiInstance = [[STRVRoutesApi alloc] init];

// List Athlete Routes
[apiInstance getRoutesByAthleteIdWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVRoute>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.RoutesApi()

var id = 56; // {Integer} The identifier of the athlete.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRoutesByAthleteId(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getRoutesByAthleteIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new RoutesApi();
            var id = 56;  // Integer | The identifier of the athlete.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Athlete Routes
                array[Route] result = apiInstance.getRoutesByAthleteId(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RoutesApi.getRoutesByAthleteId: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.RoutesApi()
id = 56 # Integer | The identifier of the athlete.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Athlete Routes
    api_response = api_instance.getRoutesByAthleteId(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RoutesApi->getRoutesByAthleteId: %s\n" % e)

Sample Response

[ {
  "private" : true,
  "distance" : 1.3579000000000001069366817318950779736042022705078125,
  "athlete" : "",
  "description" : "aeiou",
  "elevation_gain" : 1.3579000000000001069366817318950779736042022705078125,
  "type" : 123,
  "segments" : [ {
    "country" : "aeiou",
    "private" : true,
    "distance" : 1.3579000000000001069366817318950779736042022705078125,
    "average_grade" : 1.3579000000000001069366817318950779736042022705078125,
    "maximum_grade" : 1.3579000000000001069366817318950779736042022705078125,
    "climb_category" : 123,
    "city" : "aeiou",
    "elevation_high" : 1.3579000000000001069366817318950779736042022705078125,
    "athlete_pr_effort" : {
      "distance" : 1.3579000000000001069366817318950779736042022705078125,
      "start_date_local" : "2000-01-23T04:56:07.000+00:00",
      "elapsed_time" : 123,
      "is_kom" : true,
      "id" : 123456789,
      "start_date" : "2000-01-23T04:56:07.000+00:00"
    },
    "start_latlng" : "",
    "elevation_low" : 1.3579000000000001069366817318950779736042022705078125,
    "end_latlng" : "",
    "activity_type" : "aeiou",
    "name" : "aeiou",
    "id" : 123,
    "state" : "aeiou"
  } ],
  "starred" : true,
  "directions" : [ "" ],
  "sub_type" : 123,
  "name" : "aeiou",
  "id" : 123,
  "map" : {
    "summary_polyline" : "aeiou",
    "id" : "aeiou",
    "polyline" : "aeiou"
  },
  "timestamp" : 123
} ]

RunningRaces

Get Running Race (getRunningRaceById)

Returns a running race for a given identifier.

get
/running_races/{id}

Parameters

id
required Integer, in path
The identifier of the running race.

Responses

HTTP code 200 Representation of a running race An instance of RunningRace.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/running_races/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.RunningRacesApi;

import rx.Observable;

public class RunningRacesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    RunningRacesApi api = client.createService(RunningRacesApi.class);

    Integer id = 56; // Integer | The identifier of the running race.

    Observable<RunningRace> result = apiInstance.getRunningRaceById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the running race.

STRVRunningRacesApi *apiInstance = [[STRVRunningRacesApi alloc] init];

// Get Running Race
[apiInstance getRunningRaceByIdWith:id
              completionHandler: ^(STRVRunningRace output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.RunningRacesApi()

var id = 56; // {Integer} The identifier of the running race.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRunningRaceById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getRunningRaceByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new RunningRacesApi();
            var id = 56;  // Integer | The identifier of the running race.

            try
            {
                // Get Running Race
                RunningRace result = apiInstance.getRunningRaceById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RunningRacesApi.getRunningRaceById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.RunningRacesApi()
id = 56 # Integer | The identifier of the running race.

try: 
    # Get Running Race
    api_response = api_instance.getRunningRaceById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RunningRacesApi->getRunningRaceById: %s\n" % e)

Sample Response

{
  "country" : "aeiou",
  "route_ids" : [ 123 ],
  "running_race_type" : 123,
  "distance" : 1.3579000000000001069366817318950779736042022705078125,
  "website_url" : "aeiou",
  "city" : "aeiou",
  "start_date_local" : "2000-01-23T04:56:07.000+00:00",
  "name" : "aeiou",
  "measurement_preference" : "aeiou",
  "id" : 123,
  "state" : "aeiou",
  "url" : "aeiou"
}

List Running Races (getRunningRaces)

Returns a list running races based on a set of search criterias.

get
/running_races

Parameters

year
Integer, in query
Filters the list by a given year

Responses

HTTP code 200 An array of RunningRace objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/running_races?year=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.RunningRacesApi;

import rx.Observable;

public class RunningRacesApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    RunningRacesApi api = client.createService(RunningRacesApi.class);

    Integer year = 56; // Integer | Filters the list by a given year

    Observable<List<RunningRace>> result = apiInstance.getRunningRaces(year);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *year = 56; // Filters the list by a given year (optional)

STRVRunningRacesApi *apiInstance = [[STRVRunningRacesApi alloc] init];

// List Running Races
[apiInstance getRunningRacesWith:year
              completionHandler: ^(NSArray<STRVRunningRace>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.RunningRacesApi()

var opts = { 
  'year': 56 // {Integer} Filters the list by a given year
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getRunningRaces(opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getRunningRacesExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new RunningRacesApi();
            var year = 56;  // Integer | Filters the list by a given year (optional) 

            try
            {
                // List Running Races
                array[RunningRace] result = apiInstance.getRunningRaces(year);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling RunningRacesApi.getRunningRaces: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.RunningRacesApi()
year = 56 # Integer | Filters the list by a given year (optional)

try: 
    # List Running Races
    api_response = api_instance.getRunningRaces(year=year)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling RunningRacesApi->getRunningRaces: %s\n" % e)

Sample Response

[ {
  "country" : "aeiou",
  "route_ids" : [ 123 ],
  "running_race_type" : 123,
  "distance" : 1.3579000000000001069366817318950779736042022705078125,
  "website_url" : "aeiou",
  "city" : "aeiou",
  "start_date_local" : "2000-01-23T04:56:07.000+00:00",
  "name" : "aeiou",
  "measurement_preference" : "aeiou",
  "id" : 123,
  "state" : "aeiou",
  "url" : "aeiou"
} ]

SegmentEfforts

List Segment Efforts (getEffortsBySegmentId)

Returns a list of the efforts for a segment referenced by its id.

get
/segments/{id}/all_efforts

Parameters

id
required Integer, in path
The identifier of the segment.
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of DetailedSegmentEffort objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/segments/{id}/all_efforts?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.SegmentEffortsApi;

import rx.Observable;

public class SegmentEffortsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    SegmentEffortsApi api = client.createService(SegmentEffortsApi.class);

    Integer id = 56; // Integer | The identifier of the segment.
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<DetailedSegmentEffort>> result = apiInstance.getEffortsBySegmentId(id, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the segment.
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVSegmentEffortsApi *apiInstance = [[STRVSegmentEffortsApi alloc] init];

// List Segment Efforts
[apiInstance getEffortsBySegmentIdWith:id
    page:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVDetailedSegmentEffort>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.SegmentEffortsApi()

var id = 56; // {Integer} The identifier of the segment.

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getEffortsBySegmentId(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getEffortsBySegmentIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new SegmentEffortsApi();
            var id = 56;  // Integer | The identifier of the segment.
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Segment Efforts
                array[DetailedSegmentEffort] result = apiInstance.getEffortsBySegmentId(id, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SegmentEffortsApi.getEffortsBySegmentId: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.SegmentEffortsApi()
id = 56 # Integer | The identifier of the segment.
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Segment Efforts
    api_response = api_instance.getEffortsBySegmentId(id, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SegmentEffortsApi->getEffortsBySegmentId: %s\n" % e)

Sample Response

[ "" ]

Get Segment Effort (getSegmentEffortById)

Returns a segment effort for a given identifier.

get
/segment_efforts/{id}

Parameters

id
required Long, in path
The identifier of the segment effort.

Responses

HTTP code 200 Representation of a segment effort An instance of DetailedSegmentEffort.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/segment_efforts/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.SegmentEffortsApi;

import rx.Observable;

public class SegmentEffortsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    SegmentEffortsApi api = client.createService(SegmentEffortsApi.class);

    Long id = 789; // Long | The identifier of the segment effort.

    Observable<DetailedSegmentEffort> result = apiInstance.getSegmentEffortById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Long *id = 789; // The identifier of the segment effort.

STRVSegmentEffortsApi *apiInstance = [[STRVSegmentEffortsApi alloc] init];

// Get Segment Effort
[apiInstance getSegmentEffortByIdWith:id
              completionHandler: ^(STRVDetailedSegmentEffort output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.SegmentEffortsApi()

var id = 789; // {Long} The identifier of the segment effort.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getSegmentEffortById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getSegmentEffortByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new SegmentEffortsApi();
            var id = 789;  // Long | The identifier of the segment effort.

            try
            {
                // Get Segment Effort
                DetailedSegmentEffort result = apiInstance.getSegmentEffortById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SegmentEffortsApi.getSegmentEffortById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.SegmentEffortsApi()
id = 789 # Long | The identifier of the segment effort.

try: 
    # Get Segment Effort
    api_response = api_instance.getSegmentEffortById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SegmentEffortsApi->getSegmentEffortById: %s\n" % e)

Sample Response

""

Segments

Explore segments (exploreSegments)

Returns the segments matching a specified query

get
/segments/explore

Parameters

bounds
required array[Float], in query
The geographical boundaries of the search
activity_type
String, in query
The activity of the segments May take one of the following values: running, riding
min_cat
Integer, in query
The minimum category of the segment's (for climbs)
max_cat
Integer, in query
The maximum category of the segment's (for climbs)

Responses

HTTP code 200 List of matching segments An instance of ExplorerResponse.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/segments/explore?bounds=&activity_type=&min_cat=&max_cat=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.SegmentsApi;

import rx.Observable;

public class SegmentsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    SegmentsApi api = client.createService(SegmentsApi.class);

    array[Float] bounds = ; // array[Float] | The geographical boundaries of the search
    String activityType = activityType_example; // String | The activity of the segments
    Integer minCat = 56; // Integer | The minimum category of the segment's (for climbs)
    Integer maxCat = 56; // Integer | The maximum category of the segment's (for climbs)

    Observable<ExplorerResponse> result = apiInstance.exploreSegments(bounds, activityType, minCat, maxCat);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

array[Float] *bounds = ; // The geographical boundaries of the search
String *activityType = activityType_example; // The activity of the segments (optional)
Integer *minCat = 56; // The minimum category of the segment's (for climbs) (optional)
Integer *maxCat = 56; // The maximum category of the segment's (for climbs) (optional)

STRVSegmentsApi *apiInstance = [[STRVSegmentsApi alloc] init];

// Explore segments
[apiInstance exploreSegmentsWith:bounds
    activityType:activityType
    minCat:minCat
    maxCat:maxCat
              completionHandler: ^(STRVExplorerResponse output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.SegmentsApi()

var bounds = ; // {array[Float]} The geographical boundaries of the search

var opts = { 
  'activityType': activityType_example, // {String} The activity of the segments
  'minCat': 56, // {Integer} The minimum category of the segment's (for climbs)
  'maxCat': 56 // {Integer} The maximum category of the segment's (for climbs)
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.exploreSegments(bounds, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class exploreSegmentsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new SegmentsApi();
            var bounds = new array[Float](); // array[Float] | The geographical boundaries of the search
            var activityType = activityType_example;  // String | The activity of the segments (optional) 
            var minCat = 56;  // Integer | The minimum category of the segment's (for climbs) (optional) 
            var maxCat = 56;  // Integer | The maximum category of the segment's (for climbs) (optional) 

            try
            {
                // Explore segments
                ExplorerResponse result = apiInstance.exploreSegments(bounds, activityType, minCat, maxCat);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SegmentsApi.exploreSegments: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.SegmentsApi()
bounds =  # array[Float] | The geographical boundaries of the search
activityType = activityType_example # String | The activity of the segments (optional)
minCat = 56 # Integer | The minimum category of the segment's (for climbs) (optional)
maxCat = 56 # Integer | The maximum category of the segment's (for climbs) (optional)

try: 
    # Explore segments
    api_response = api_instance.exploreSegments(bounds, activityType=activityType, minCat=minCat, maxCat=maxCat)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SegmentsApi->exploreSegments: %s\n" % e)

Sample Response

{
  "segments" : [ {
    "distance" : 1.3579000000000001069366817318950779736042022705078125,
    "climb_category" : 123,
    "end_latlng" : "",
    "climb_category_desc" : "aeiou",
    "name" : "aeiou",
    "id" : 123,
    "elev_difference" : 1.3579000000000001069366817318950779736042022705078125,
    "avg_grade" : 1.3579000000000001069366817318950779736042022705078125,
    "start_latlng" : "",
    "points" : "aeiou"
  } ]
}

Get Segment Leaderboard (getLeaderboardBySegmentId)

Returns the leaderboard of a segment.

get
/segments/{id}/leaderboard

Parameters

id
required Integer, in path
The identifier of the segment to get leaderbaords for.
gender
String, in query
Enables filtering of entries by a given gender May take one of the following values: M, F
age_group
String, in query
Enables filtering of entries by a given age-group May take one of the following values: 0_24, 25_34, 35_44, 45_54, 55_64, 65_plus
weight_class
String, in query
Enables filtering of entries by a given weight class May take one of the following values: 0_124, 125_149, 150_164, 165_179, 180_199, 200_plus, 0_54, 55_64, 65_74, 75_84, 85_94, 95_plus
following
Boolean, in query
Enables filtering of entries by the friends of the logged-in athlete
club_id
Integer, in query
Enables filtering of entries by the membership of a given clu
date_range
String, in query
Enables filtering of entries by a given date range May take one of the following values: this_year, this_month, this_week, today
context_entries
Integer, in query
page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 Representation of a segment leaderboard An instance of SegmentLeaderboard.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/segments/{id}/leaderboard?gender=&age_group=&weight_class=&following=&club_id=&date_range=&context_entries=&page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.SegmentsApi;

import rx.Observable;

public class SegmentsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    SegmentsApi api = client.createService(SegmentsApi.class);

    Integer id = 56; // Integer | The identifier of the segment to get leaderbaords for.
    String gender = gender_example; // String | Enables filtering of entries by a given gender
    String ageGroup = ageGroup_example; // String | Enables filtering of entries by a given age-group
    String weightClass = weightClass_example; // String | Enables filtering of entries by a given weight class
    Boolean following = true; // Boolean | Enables filtering of entries by the friends of the logged-in athlete
    Integer clubId = 56; // Integer | Enables filtering of entries by the membership of a given clu
    String dateRange = dateRange_example; // String | Enables filtering of entries by a given date range
    Integer contextEntries = 56; // Integer | 
    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<SegmentLeaderboard> result = apiInstance.getLeaderboardBySegmentId(id, gender, ageGroup, weightClass, following, clubId, dateRange, contextEntries, page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the segment to get leaderbaords for.
String *gender = gender_example; // Enables filtering of entries by a given gender (optional)
String *ageGroup = ageGroup_example; // Enables filtering of entries by a given age-group (optional)
String *weightClass = weightClass_example; // Enables filtering of entries by a given weight class (optional)
Boolean *following = true; // Enables filtering of entries by the friends of the logged-in athlete (optional)
Integer *clubId = 56; // Enables filtering of entries by the membership of a given clu (optional)
String *dateRange = dateRange_example; // Enables filtering of entries by a given date range (optional)
Integer *contextEntries = 56; //  (optional)
Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVSegmentsApi *apiInstance = [[STRVSegmentsApi alloc] init];

// Get Segment Leaderboard
[apiInstance getLeaderboardBySegmentIdWith:id
    gender:gender
    ageGroup:ageGroup
    weightClass:weightClass
    following:following
    clubId:clubId
    dateRange:dateRange
    contextEntries:contextEntries
    page:page
    perPage:perPage
              completionHandler: ^(STRVSegmentLeaderboard output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.SegmentsApi()

var id = 56; // {Integer} The identifier of the segment to get leaderbaords for.

var opts = { 
  'gender': gender_example, // {String} Enables filtering of entries by a given gender
  'ageGroup': ageGroup_example, // {String} Enables filtering of entries by a given age-group
  'weightClass': weightClass_example, // {String} Enables filtering of entries by a given weight class
  'following': true, // {Boolean} Enables filtering of entries by the friends of the logged-in athlete
  'clubId': 56, // {Integer} Enables filtering of entries by the membership of a given clu
  'dateRange': dateRange_example, // {String} Enables filtering of entries by a given date range
  'contextEntries': 56, // {Integer} 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLeaderboardBySegmentId(id, opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLeaderboardBySegmentIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new SegmentsApi();
            var id = 56;  // Integer | The identifier of the segment to get leaderbaords for.
            var gender = gender_example;  // String | Enables filtering of entries by a given gender (optional) 
            var ageGroup = ageGroup_example;  // String | Enables filtering of entries by a given age-group (optional) 
            var weightClass = weightClass_example;  // String | Enables filtering of entries by a given weight class (optional) 
            var following = true;  // Boolean | Enables filtering of entries by the friends of the logged-in athlete (optional) 
            var clubId = 56;  // Integer | Enables filtering of entries by the membership of a given clu (optional) 
            var dateRange = dateRange_example;  // String | Enables filtering of entries by a given date range (optional) 
            var contextEntries = 56;  // Integer |  (optional) 
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // Get Segment Leaderboard
                SegmentLeaderboard result = apiInstance.getLeaderboardBySegmentId(id, gender, ageGroup, weightClass, following, clubId, dateRange, contextEntries, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SegmentsApi.getLeaderboardBySegmentId: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.SegmentsApi()
id = 56 # Integer | The identifier of the segment to get leaderbaords for.
gender = gender_example # String | Enables filtering of entries by a given gender (optional)
ageGroup = ageGroup_example # String | Enables filtering of entries by a given age-group (optional)
weightClass = weightClass_example # String | Enables filtering of entries by a given weight class (optional)
following = true # Boolean | Enables filtering of entries by the friends of the logged-in athlete (optional)
clubId = 56 # Integer | Enables filtering of entries by the membership of a given clu (optional)
dateRange = dateRange_example # String | Enables filtering of entries by a given date range (optional)
contextEntries = 56 # Integer |  (optional)
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # Get Segment Leaderboard
    api_response = api_instance.getLeaderboardBySegmentId(id, gender=gender, ageGroup=ageGroup, weightClass=weightClass, following=following, clubId=clubId, dateRange=dateRange, contextEntries=contextEntries, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SegmentsApi->getLeaderboardBySegmentId: %s\n" % e)

Sample Response

{
  "entries" : [ {
    "distance" : 1.3579000000000001069366817318950779736042022705078125,
    "athlete_id" : 123,
    "start_date_local" : "2000-01-23T04:56:07.000+00:00",
    "athlete_profile" : "aeiou",
    "average_watts" : 1.3579000000000001069366817318950779736042022705078125,
    "average_hr" : 1.3579000000000001069366817318950779736042022705078125,
    "athlete_gender" : "aeiou",
    "effort_id" : 123456789,
    "elapsed_time" : 123,
    "activity_id" : 123,
    "rank" : 123,
    "athlete_name" : "aeiou",
    "moving_time" : 123,
    "start_date" : "2000-01-23T04:56:07.000+00:00"
  } ],
  "entry_count" : 123
}

List Starred Segments (getLoggedInAthleteStarredSegments)

Returns a list of the segments starred by logged-in athlete.

get
/segments/starred

Parameters

page
Integer, in query
Page number
per_page
Integer, in query
Number of items per page

Responses

HTTP code 200 An array of SummarySegment objects.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/segments/starred?page=&per_page=" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.SegmentsApi;

import rx.Observable;

public class SegmentsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    SegmentsApi api = client.createService(SegmentsApi.class);

    Integer page = 56; // Integer | Page number
    Integer perPage = 56; // Integer | Number of items per page

    Observable<List<SummarySegment>> result = apiInstance.getLoggedInAthleteStarredSegments(page, perPage);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *page = 56; // Page number (optional)
Integer *perPage = 56; // Number of items per page (optional) (default to 30)

STRVSegmentsApi *apiInstance = [[STRVSegmentsApi alloc] init];

// List Starred Segments
[apiInstance getLoggedInAthleteStarredSegmentsWith:page
    perPage:perPage
              completionHandler: ^(NSArray<STRVSummarySegment>* output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.SegmentsApi()

var opts = { 
  'page': 56, // {Integer} Page number
  'perPage': 56 // {Integer} Number of items per page
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getLoggedInAthleteStarredSegments(opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getLoggedInAthleteStarredSegmentsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new SegmentsApi();
            var page = 56;  // Integer | Page number (optional) 
            var perPage = 56;  // Integer | Number of items per page (optional)  (default to 30)

            try
            {
                // List Starred Segments
                array[SummarySegment] result = apiInstance.getLoggedInAthleteStarredSegments(page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SegmentsApi.getLoggedInAthleteStarredSegments: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.SegmentsApi()
page = 56 # Integer | Page number (optional)
perPage = 56 # Integer | Number of items per page (optional) (default to 30)

try: 
    # List Starred Segments
    api_response = api_instance.getLoggedInAthleteStarredSegments(page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SegmentsApi->getLoggedInAthleteStarredSegments: %s\n" % e)

Sample Response

[ {
  "country" : "aeiou",
  "private" : true,
  "distance" : 1.3579000000000001069366817318950779736042022705078125,
  "average_grade" : 1.3579000000000001069366817318950779736042022705078125,
  "maximum_grade" : 1.3579000000000001069366817318950779736042022705078125,
  "climb_category" : 123,
  "city" : "aeiou",
  "elevation_high" : 1.3579000000000001069366817318950779736042022705078125,
  "athlete_pr_effort" : {
    "distance" : 1.3579000000000001069366817318950779736042022705078125,
    "start_date_local" : "2000-01-23T04:56:07.000+00:00",
    "elapsed_time" : 123,
    "is_kom" : true,
    "id" : 123456789,
    "start_date" : "2000-01-23T04:56:07.000+00:00"
  },
  "start_latlng" : "",
  "elevation_low" : 1.3579000000000001069366817318950779736042022705078125,
  "end_latlng" : "",
  "activity_type" : "aeiou",
  "name" : "aeiou",
  "id" : 123,
  "state" : "aeiou"
} ]

Get Segment (getSegmentById)

Returns the segment identified by the given identifier.

get
/segments/{id}

Parameters

id
required Integer, in path
The identifier of the segment.

Responses

HTTP code 200 Representation of a segment An instance of DetailedSegment.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/segments/{id}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.SegmentsApi;

import rx.Observable;

public class SegmentsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    SegmentsApi api = client.createService(SegmentsApi.class);

    Integer id = 56; // Integer | The identifier of the segment.

    Observable<DetailedSegment> result = apiInstance.getSegmentById(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the segment.

STRVSegmentsApi *apiInstance = [[STRVSegmentsApi alloc] init];

// Get Segment
[apiInstance getSegmentByIdWith:id
              completionHandler: ^(STRVDetailedSegment output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.SegmentsApi()

var id = 56; // {Integer} The identifier of the segment.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getSegmentById(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getSegmentByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new SegmentsApi();
            var id = 56;  // Integer | The identifier of the segment.

            try
            {
                // Get Segment
                DetailedSegment result = apiInstance.getSegmentById(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SegmentsApi.getSegmentById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.SegmentsApi()
id = 56 # Integer | The identifier of the segment.

try: 
    # Get Segment
    api_response = api_instance.getSegmentById(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SegmentsApi->getSegmentById: %s\n" % e)

Sample Response

""

Star Segment (starSegment)

Stars a segment referenced by its identifier.

put
/segments/{id}/starred

Parameters

id
required Integer, in path
The identifier of the segment to star.

Responses

HTTP code 200 Representation of a segment An instance of DetailedSegment.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http put "https://www.strava.com/api/v3/segments/{id}/starred" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.SegmentsApi;

import rx.Observable;

public class SegmentsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    SegmentsApi api = client.createService(SegmentsApi.class);

    Integer id = 56; // Integer | The identifier of the segment to star.

    Observable<DetailedSegment> result = apiInstance.starSegment(id);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *id = 56; // The identifier of the segment to star.

STRVSegmentsApi *apiInstance = [[STRVSegmentsApi alloc] init];

// Star Segment
[apiInstance starSegmentWith:id
              completionHandler: ^(STRVDetailedSegment output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.SegmentsApi()

var id = 56; // {Integer} The identifier of the segment to star.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.starSegment(id, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class starSegmentExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new SegmentsApi();
            var id = 56;  // Integer | The identifier of the segment to star.

            try
            {
                // Star Segment
                DetailedSegment result = apiInstance.starSegment(id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SegmentsApi.starSegment: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.SegmentsApi()
id = 56 # Integer | The identifier of the segment to star.

try: 
    # Star Segment
    api_response = api_instance.starSegment(id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SegmentsApi->starSegment: %s\n" % e)

Sample Response

""

Uploads

Upload Activity (createUpload)

Uploads a new data file to create an activity from.

post
/uploads

Parameters

file
File, in form
The uploaded file
name
String, in form
The desired name of the resulting activity.
description
String, in form
The desired description of the resulting activity.
private
Integer, in form
Whether the resulting activity should be private.
trainer
String, in form
Whether the resulting activity should be marked as having been performed on a trainer.
commute
String, in form
Whether the resulting activity should be tagged as a commute.
data_type
String, in form
The format of the uploaded file. May take one of the following values: fit, fit.gz, tcx, tcx.gz, gpx, gpx.gz
external_id
String, in form
The desired external identifier of the resulting activity.

Responses

HTTP code 201 A representation of the created upload An instance of Upload.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http post "https://www.strava.com/api/v3/uploads" file@/path/to/file name='value' description='value' private='value' trainer='value' commute='value' data_type='value' external_id='value' "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.UploadsApi;

import rx.Observable;

public class UploadsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    UploadsApi api = client.createService(UploadsApi.class);

    File file = /path/to/file.txt; // File | The uploaded file
    String name = name_example; // String | The desired name of the resulting activity.
    String description = description_example; // String | The desired description of the resulting activity.
    Integer private = 56; // Integer | Whether the resulting activity should be private.
    String trainer = trainer_example; // String | Whether the resulting activity should be marked as having been performed on a trainer.
    String commute = commute_example; // String | Whether the resulting activity should be tagged as a commute.
    String dataType = dataType_example; // String | The format of the uploaded file.
    String externalId = externalId_example; // String | The desired external identifier of the resulting activity.

    Observable<Upload> result = apiInstance.createUpload(file, name, description, private, trainer, commute, dataType, externalId);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

File *file = /path/to/file.txt; // The uploaded file (optional)
String *name = name_example; // The desired name of the resulting activity. (optional)
String *description = description_example; // The desired description of the resulting activity. (optional)
Integer *private = 56; // Whether the resulting activity should be private. (optional)
String *trainer = trainer_example; // Whether the resulting activity should be marked as having been performed on a trainer. (optional)
String *commute = commute_example; // Whether the resulting activity should be tagged as a commute. (optional)
String *dataType = dataType_example; // The format of the uploaded file. (optional)
String *externalId = externalId_example; // The desired external identifier of the resulting activity. (optional)

STRVUploadsApi *apiInstance = [[STRVUploadsApi alloc] init];

// Upload Activity
[apiInstance createUploadWith:file
    name:name
    description:description
    private:private
    trainer:trainer
    commute:commute
    dataType:dataType
    externalId:externalId
              completionHandler: ^(STRVUpload output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.UploadsApi()

var opts = { 
  'file': /path/to/file.txt, // {File} The uploaded file
  'name': name_example, // {String} The desired name of the resulting activity.
  'description': description_example, // {String} The desired description of the resulting activity.
  'private': 56, // {Integer} Whether the resulting activity should be private.
  'trainer': trainer_example, // {String} Whether the resulting activity should be marked as having been performed on a trainer.
  'commute': commute_example, // {String} Whether the resulting activity should be tagged as a commute.
  'dataType': dataType_example, // {String} The format of the uploaded file.
  'externalId': externalId_example // {String} The desired external identifier of the resulting activity.
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.createUpload(opts, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class createUploadExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new UploadsApi();
            var file = new File(); // File | The uploaded file (optional) 
            var name = name_example;  // String | The desired name of the resulting activity. (optional) 
            var description = description_example;  // String | The desired description of the resulting activity. (optional) 
            var private = 56;  // Integer | Whether the resulting activity should be private. (optional) 
            var trainer = trainer_example;  // String | Whether the resulting activity should be marked as having been performed on a trainer. (optional) 
            var commute = commute_example;  // String | Whether the resulting activity should be tagged as a commute. (optional) 
            var dataType = dataType_example;  // String | The format of the uploaded file. (optional) 
            var externalId = externalId_example;  // String | The desired external identifier of the resulting activity. (optional) 

            try
            {
                // Upload Activity
                Upload result = apiInstance.createUpload(file, name, description, private, trainer, commute, dataType, externalId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling UploadsApi.createUpload: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.UploadsApi()
file = /path/to/file.txt # File | The uploaded file (optional)
name = name_example # String | The desired name of the resulting activity. (optional)
description = description_example # String | The desired description of the resulting activity. (optional)
private = 56 # Integer | Whether the resulting activity should be private. (optional)
trainer = trainer_example # String | Whether the resulting activity should be marked as having been performed on a trainer. (optional)
commute = commute_example # String | Whether the resulting activity should be tagged as a commute. (optional)
dataType = dataType_example # String | The format of the uploaded file. (optional)
externalId = externalId_example # String | The desired external identifier of the resulting activity. (optional)

try: 
    # Upload Activity
    api_response = api_instance.createUpload(file=file, name=name, description=description, private=private, trainer=trainer, commute=commute, dataType=dataType, externalId=externalId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling UploadsApi->createUpload: %s\n" % e)

Sample Response

{
  "activity_id" : 123,
  "external_id" : "aeiou",
  "id" : 123,
  "error" : "aeiou",
  "status" : "aeiou"
}

Get Upload (getUploadById)

Returns an upload for a given identifier.

get
/uploads/{uploadId}

Parameters

uploadId
required Integer, in path
The identifier of the upload.

Responses

HTTP code 200 Representation of the upload An instance of Upload.
HTTP code 4xx, 5xx a Fault describing the reason for the error.
$ http get "https://www.strava.com/api/v3/uploads/{uploadId}" "Authorization: Bearer [[token]]"
import com.strava.api.v3.*;
import com.strava.api.v3.auth.*;
import com.strava.api.v3.model.*;
import com.strava.api.v3.api.UploadsApi;

import rx.Observable;

public class UploadsApiExample {
  public static void main(String... args) {
    ApiClient client = new ApiClient(...);
    UploadsApi api = client.createService(UploadsApi.class);

    Integer uploadId = 56; // Integer | The identifier of the upload.

    Observable<Upload> result = apiInstance.getUploadById(uploadId);
    result.subscribe(System.out::println, Throwable::printStackTrace);
  }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure OAuth2 access token for authorization: (authentication scheme: strava_oauth)
[apiConfig setAccessToken:@"YOUR_ACCESS_TOKEN"];

Integer *uploadId = 56; // The identifier of the upload.

STRVUploadsApi *apiInstance = [[STRVUploadsApi alloc] init];

// Get Upload
[apiInstance getUploadByIdWith:uploadId
              completionHandler: ^(STRVUpload output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var StravaApiV3 = require('strava_api_v3');
var defaultClient = StravaApiV3.ApiClient.instance;

// Configure OAuth2 access token for authorization: strava_oauth
var strava_oauth = defaultClient.authentications['strava_oauth'];
strava_oauth.accessToken = "YOUR ACCESS TOKEN"

var api = new StravaApiV3.UploadsApi()

var uploadId = 56; // {Integer} The identifier of the upload.


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.getUploadById(uploadId, callback);
using System;
using System.Diagnostics;
using com.strava.api.v3.Api;
using com.strava.api.v3.Client;
using com.strava.api.v3.Model;

namespace Example
{
    public class getUploadByIdExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: strava_oauth
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new UploadsApi();
            var uploadId = 56;  // Integer | The identifier of the upload.

            try
            {
                // Get Upload
                Upload result = apiInstance.getUploadById(uploadId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling UploadsApi.getUploadById: " + e.Message );
            }
        }
    }
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: strava_oauth
swagger_client.configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = swagger_client.UploadsApi()
uploadId = 56 # Integer | The identifier of the upload.

try: 
    # Get Upload
    api_response = api_instance.getUploadById(uploadId)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling UploadsApi->getUploadById: %s\n" % e)

Sample Response

{
  "activity_id" : 123,
  "external_id" : "aeiou",
  "id" : 123,
  "error" : "aeiou",
  "status" : "aeiou"
}

All Models

ActivityStats

A set of rolled-up statistics and totals for an athlete

biggest_ride_distance
double
The longest distance ridden by the athlete.
biggest_climb_elevation_gain
double
The highest climb ridden by the athlete.
recent_ride_totals
ActivityTotal
An instance of ActivityTotal.
recent_run_totals
ActivityTotal
An instance of ActivityTotal.
recent_swim_totals
ActivityTotal
An instance of ActivityTotal.
ytd_ride_totals
ActivityTotal
An instance of ActivityTotal.
ytd_run_totals
ActivityTotal
An instance of ActivityTotal.
ytd_swim_totals
ActivityTotal
An instance of ActivityTotal.
all_ride_totals
ActivityTotal
An instance of ActivityTotal.
all_run_totals
ActivityTotal
An instance of ActivityTotal.
all_swim_totals
ActivityTotal
An instance of ActivityTotal.

ActivityTotal

A roll-up of metrics pertaining to a set of activities.

count
integer
The number of activities considered in this total.
distance
float
The total distance covered by the considered activities.
moving_time
integer
The total moving time of the considered activities.
elapsed_time
integer
The total elapsed time of the considered activities.
elevation_gain
float
The total elevation gain of the considered activities.
achievement_count
integer
The total number of achievements of the considered activities.

ActivityType

An enumeration of the types an activity may have.

>May take one of the following values: AlpineSki, BackcountrySki, Canoeing, Crossfit, EBikeRide, Elliptical, Hike, IceSkate, InlineSkate, Kayaking, Kitesurf, NordicSki, Ride, RockClimbing, RollerSki, Rowing, Run, Snowboard, Snowshoe, StairStepper, StandUpPaddling, Surfing, Swim, VirtualRide, Walk, WeightTraining, Windsurf, Workout, Yoga

ActivityZone

score
integer
An instance of integer.
distribution_buckets
#/TimedZoneDistribution
An instance of #/TimedZoneDistribution.
type
string
May take one of the following values: heartrate, power
sensor_based
boolean
An instance of boolean.
points
integer
An instance of integer.
custom_zones
boolean
An instance of boolean.
max
integer
An instance of integer.

ClubAnnouncement

id
integer
The unique identifier of this announcement.
club_id
integer
The unique identifier of the club this announcements was made in.
athlete
SummaryAthlete
An instance of SummaryAthlete.
created_at
DateTime
The time at which this announcement was created.
message
string
The content of this announcement

Comment

id
integer
The unique identifier of this comment
activity_id
integer
The identifier of the activity this comment is related to
text
string
The content of the comment
athlete
SummaryAthlete
An instance of SummaryAthlete.
created_at
DateTime
The time at which this comment was created.

DetailedActivity

id
integer
The unique identifier of the activity
external_id
string
The identifier provided at upload time
upload_id
integer
The identifier of the upload that resulted in this activity
athlete
MetaAthlete
An instance of MetaAthlete.
name
string
The name of the activity
distance
float
The activity's distance, in meters
moving_time
integer
The activity's moving time
elapsed_time
integer
The activity's elapsed time
total_elevation_gain
float
The activity's total elevation gain.
elev_high
float
The activity's highest elevation, in meters
elev_low
float
The activity's lowest elevation, in meters
type
ActivityType
An instance of ActivityType.
start_date
DateTime
The time at which the activity was started.
start_date_local
DateTime
The time at which the activity was started in the local timezone.
timezone
string
The timezone of the activity
start_latlng
LatLng
An instance of LatLng.
end_latlng
LatLng
An instance of LatLng.
achievement_count
integer
The number of achievements gained during this activity
kudos_count
integer
The number of kudos given for this activity
comment_count
integer
The number of comments for this activity
athlete_count
integer
The number of athletes for taking part in a group activity
photo_count
integer
The number of Instagram photos for this activity
total_photo_count
integer
The number of Instagram and Strava photos for this activity
map
PolylineMap
An instance of PolylineMap.
trainer
boolean
Whether this activity was recorded on a training machine
commute
boolean
Whether this activity is a commute
manual
boolean
Whether this activity was created manually
private
boolean
Whether this activity is private
flagged
boolean
Whether this activity is flagged
workout_type
integer
The activity's workout type
average_speed
float
The activity's average speed, in meters per second
max_speed
float
The activity's max speed, in meters per second
has_kudoed
boolean
Whether the logged-in athlete has kudoed this activity
description
string
The description of the activity
photos
PhotosSummary
An instance of PhotosSummary.
gear
SummaryGear
An instance of SummaryGear.
calories
float
The number of kilocalories consumed during this activity
segment_efforts
DetailedSegmentEffort
A collection of DetailedSegmentEffort objects.
device_name
string
The name of the device used to record the activity
embed_token
string
The token used to embed a Strava activity
splits_metric
Split
The splits of this activity in metric units (for runs)
splits_standard
Split
The splits of this activity in imperial units (for runs)
laps
Lap
A collection of Lap objects.
best_efforts
DetailedSegmentEffort
A collection of DetailedSegmentEffort objects.

DetailedAthlete

id
integer
The unique identifier of the athlete
resource_state
integer
Resource state
firstname
string
The athlete's first name.
lastname
string
The athlete's last name.
profile_medium
string
URL to a 62x62 pixel profile picture.
profile
string
URL to a 124x124 pixel profile picture.
city
string
The athlete's city.
state
string
The athlete's state or geographical region.
country
string
The athlete's country.
sex
string
The athlete's sex. May take one of the following values: M, F
friend
string
Whether the currently logged-in athlete follows this athlete. May take one of the following values: pending, accepted, blocked
follower
string
Whether this athlete follows the currently logged-in athlete. May take one of the following values: pending, accepted, blocked
premium
boolean
The athlete's premium status.
created_at
DateTime
The time at which the athlete was created.
updated_at
DateTime
The time at which the athlete was last updated.
follower_count
integer
The athlete's follower count.
friend_count
integer
The athlete's friend count.
mutual_friend_count
integer
The number or athletes mutually followed by this athlete and the currently logged-in athlete.
measurement_preference
string
The athlete's preferred unit system. May take one of the following values: feet, meters
email
string
The athlete's email address.
ftp
integer
The athlete's FTP (Functional Threshold Power).
weight
float
The athlete's weight.
clubs
SummaryClub
The athlete's clubs.
bikes
SummaryGear
The athlete's bikes.
shoes
SummaryGear
The athlete's shoes.

DetailedClub

id
integer
The club's unique identifier.
resource_state
integer
Resource state
name
string
The club's name.
profile_medium
string
URL to a 60x60 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
May take one of the following values: cycling, running, triathlon, other
city
string
The club's city.
state
string
The club's state or geographical region.
country
string
The club's country.
private
boolean
Whether the club is private.
member_count
integer
The club's member count.
featured
boolean
Whether the club is featured or not.
verified
boolean
Whether the club is verified or not.
url
string
The club's vanity URL.
membership
string
The membership status of the logged-in athlete. May take one of the following values: member, pending
admin
boolean
Whether the currently logged-in athlete is an administrator of this club.
owner
boolean
Whether the currently logged-in athlete is the owner of this club.
following_count
integer
The number of athletes in the club that the logged-in athlete follows.

DetailedGear

id
string
The gear's unique identifier.
resource_state
integer
Resource state
primary
boolean
Whether this gear's is the owner's default one.
name
string
The gear's name.
distance
float
The distance logged with this gear.
brand_name
string
The gear's brand name.
model_name
string
The gear's model name.
frame_type
integer
The gear's frame type (bike only).
description
string
The gear's description.

DetailedSegment

id
integer
The unique identifier of this segment
name
string
The name of this segment
activity_type
string
May take one of the following values: Ride, Run
distance
float
The segment's distance, in meters
average_grade
float
The segment's average grade, in percents
maximum_grade
float
The segments's maximum grade, in percents
elevation_high
float
The segments's highest elevation, in meters
elevation_low
float
The segments's lowest elevation, in meters
start_latlng
LatLng
An instance of LatLng.
end_latlng
LatLng
An instance of LatLng.
climb_category
integer
The category of the climb
city
string
The segments's city.
state
string
The segments's state or geographical region.
country
string
The segment's country.
private
boolean
Whether this segment is private.
athlete_pr_effort
SummarySegmentEffort
An instance of SummarySegmentEffort.
created_at
DateTime
The time at which the segment was created.
updated_at
DateTime
The time at which the segment was last updated.
total_elevation_gain
float
The segment's total elevation gain.
map
PolylineMap
An instance of PolylineMap.
effort_count
integer
The total number of efforts for this segment
athlete_count
integer
The number of unique athletes who have an effort for this segment
hazardous
boolean
Whether this segment is considered hazardous
star_count
integer
The number of stars for this segment

DetailedSegmentEffort

id
long
The unique identifier of this effort
elapsed_time
integer
The effort's elapsed time
start_date
DateTime
The time at which the effort was started.
start_date_local
DateTime
The time at which the effort was started in the local timezone.
distance
float
The effort's distance in meters
is_kom
boolean
Whether this effort is the current best on the leaderboard
name
string
The name of the segment on which this effort was performed
activity
MetaActivity
An instance of MetaActivity.
athlete
MetaAthlete
An instance of MetaAthlete.
moving_time
integer
The effort's moving time
start_index
integer
The start index of this effort in its activity's stream
end_index
integer
The end index of this effort in its activity's stream
average_cadence
float
The effort's average cadence
average_watts
float
The average wattage of this effort
device_watts
boolean
For riding efforts, whether the wattage was reported by a dedicated recording device
average_heartrate
float
The heart heart rate of the athlete during this effort
max_heartrate
float
The maximum heart rate of the athlete during this effort
segment
SummarySegment
An instance of SummarySegment.
kom_rank
integer
The rank of the effort on the global leaderboard if it belongs in the top 10 at the time of upload
pr_rank
integer
The rank of the effort on the athlete's leaderboard if it belongs in the top 3 at the time of upload
hidden
boolean
Whether this effort should be hidden when viewed within an activity

Error

code
string
The code associated with this error.
field
string
The specific field or aspect of the resource associated with this error.
resource
string
The type of resource associated with this error.

ExplorerResponse

segments
ExplorerSegment
The set of segments matching an explorer request

ExplorerSegment

id
integer
The unique identifier of this segment
name
string
The name of this segment
climb_category
integer
The category of the climb
climb_category_desc
string
The description for the category of the climb May take one of the following values: NC, 4, 3, 2, 1, HC
avg_grade
float
The segment's average grade, in percents
start_latlng
LatLng
An instance of LatLng.
end_latlng
LatLng
An instance of LatLng.
elev_difference
float
The segments's evelation difference, in meters
distance
float
The segment's distance, in meters
points
string
The polyline of the segment

Fault

Encapsulates the errors that may be returned from the API.

errors
Error
The set of specific errors associated with this fault, if any.
message
string
The message of the fault.

HeartRateZoneRanges

custom_zones
boolean
Whether the athlete has set their own custom heart rate zones
zones
ZoneRanges
An instance of ZoneRanges.

Lap

id
long
The unique identifier of this lap
activity
MetaActivity
An instance of MetaActivity.
athlete
MetaAthlete
An instance of MetaAthlete.
average_cadence
float
The lap's average cadence
average_speed
float
The lap's average speed
distance
float
The lap's distance, in meters
elapsed_time
integer
The lap's elapsed time, in seconds
start_index
integer
The start index of this effort in its activity's stream
end_index
integer
The end index of this effort in its activity's stream
lap_index
integer
The index of this lap in the activity it belongs to
max_speed
float
The maximum speed of this lat, in meters per second
moving_time
integer
The lap's moving time, in seconds
name
string
The name of the lap
pace_zone
integer
The athlete's pace zone during this lap
split
integer
An instance of integer.
start_date
DateTime
The time at which the lap was started.
start_date_local
DateTime
The time at which the lap was started in the local timezone.
total_elevation_gain
float
The elevation gain of this lap, in meters

LatLng

A collection of float objects. A pair of latitude/longitude coordinates, represented as an array of 2 floating point numbers.

MembershipApplication

success
boolean
Whether the application for membership was successfully submitted
active
boolean
Whether the membership is currently active
membership
string
The membership status of this application May take one of the following values: member, pending

MetaActivity

id
integer
The unique identifier of the activity

MetaAthlete

id
integer
The unique identifier of the athlete

MetaClub

id
integer
The club's unique identifier.
resource_state
integer
Resource state
name
string
The club's name.

PhotosSummary

count
integer
The number of photos
primary
PhotosSummary_primary
An instance of PhotosSummary_primary.

PhotosSummary_primary

id
integer
An instance of integer.
source
integer
An instance of integer.
unique_id
string
An instance of string.
urls
string
An instance of string.

PolylineMap

id
string
The identifier of the map
polyline
string
The polyline of the map
summary_polyline
string
The summary polyline of the map

PowerZoneRanges

zones
ZoneRanges
An instance of ZoneRanges.

Route

athlete
SummaryAthlete
An instance of SummaryAthlete.
description
string
The description of the route
distance
float
The route's distance, in meters
elevation_gain
float
The route's elevation gain.
id
integer
The unique identifier of this route
map
PolylineMap
An instance of PolylineMap.
name
string
The name of this route
private
boolean
Whether this route is private
starred
boolean
Whether this route is starred by the logged-in athlete
timestamp
integer
An instance of integer.
type
integer
This route's type (1 for ride, 2 for runs)
sub_type
integer
This route's sub-type (1 for road, 2 for mountain bike, 3 for cross, 4 for trail, 5 for mixed)
segments
SummarySegment
The segments traversed by this route
directions
#/RouteDirection
The directions of this route

RouteDirection

distance
float
The distance in the route at which the action applies
action
integer
The action of this direction
name
string
An instance of string.

RunningRace

id
integer
The unique identifier of this race.
name
string
The name of this race.
running_race_type
integer
The type of this race.
distance
float
The race's distance, in meters.
start_date_local
DateTime
The time at which the race begins started in the local timezone.
city
string
The name of the city in which the race is taking place.
state
string
The name of the state or geographical region in which the race is taking place.
country
string
The name of the country in which the race is taking place.
route_ids
integer
The set of routes that cover this race's course.
measurement_preference
string
The unit system in which the race should be displayed. May take one of the following values: feet, meters
url
string
The vanity URL of this race on Strava.
website_url
string
The URL of this race's website.

SegmentLeaderboard

A

entry_count
integer
The total number of entries for this leaderboard
entries
SegmentLeaderboardEntry
A collection of SegmentLeaderboardEntry objects.

SegmentLeaderboardEntry

A row in a segment leaderboard

athlete_name
string
The name of the athlete
athlete_id
integer
The unique identifier of the athlete
athlete_gender
string
May take one of the following values: M, F
average_hr
float
The average cadence of the effort associated with this entry
average_watts
float
The average wattage of the effort associated with this entry
distance
float
The effort's distance in meters
elapsed_time
integer
The elapsed of the segment effort associated with this entry
moving_time
integer
The moving of the segment effort associated with this entry
start_date
DateTime
The time at which the effort was started.
start_date_local
DateTime
The time at which the effort was started in the local timezone.
activity_id
integer
The unique identifier of the activity associated with this entry
effort_id
long
The unique identifier of the segment effort associated with this entry
rank
integer
The rank of this entry in the leaderboard
athlete_profile
string
The URL of the athlete's profile picture

Split

average_speed
float
The average speed of this split, in meters per second
distance
float
The distance of this split, in meters
elapsed_time
integer
The elapsed time of this split, in seconds
elevation_difference
float
The elevation difference of this split, in meters
pace_zone
integer
The pacing zone of this split
moving_time
integer
The moving time of this split, in seconds
split
integer
N/A

SummaryActivity

id
integer
The unique identifier of the activity
external_id
string
The identifier provided at upload time
upload_id
integer
The identifier of the upload that resulted in this activity
athlete
MetaAthlete
An instance of MetaAthlete.
name
string
The name of the activity
distance
float
The activity's distance, in meters
moving_time
integer
The activity's moving time
elapsed_time
integer
The activity's elapsed time
total_elevation_gain
float
The activity's total elevation gain.
elev_high
float
The activity's highest elevation, in meters
elev_low
float
The activity's lowest elevation, in meters
type
ActivityType
An instance of ActivityType.
start_date
DateTime
The time at which the activity was started.
start_date_local
DateTime
The time at which the activity was started in the local timezone.
timezone
string
The timezone of the activity
start_latlng
LatLng
An instance of LatLng.
end_latlng
LatLng
An instance of LatLng.
achievement_count
integer
The number of achievements gained during this activity
kudos_count
integer
The number of kudos given for this activity
comment_count
integer
The number of comments for this activity
athlete_count
integer
The number of athletes for taking part in a group activity
photo_count
integer
The number of Instagram photos for this activity
total_photo_count
integer
The number of Instagram and Strava photos for this activity
map
PolylineMap
An instance of PolylineMap.
trainer
boolean
Whether this activity was recorded on a training machine
commute
boolean
Whether this activity is a commute
manual
boolean
Whether this activity was created manually
private
boolean
Whether this activity is private
flagged
boolean
Whether this activity is flagged
workout_type
integer
The activity's workout type
average_speed
float
The activity's average speed, in meters per second
max_speed
float
The activity's max speed, in meters per second
has_kudoed
boolean
Whether the logged-in athlete has kudoed this activity

SummaryAthlete

id
integer
The unique identifier of the athlete
resource_state
integer
Resource state
firstname
string
The athlete's first name.
lastname
string
The athlete's last name.
profile_medium
string
URL to a 62x62 pixel profile picture.
profile
string
URL to a 124x124 pixel profile picture.
city
string
The athlete's city.
state
string
The athlete's state or geographical region.
country
string
The athlete's country.
sex
string
The athlete's sex. May take one of the following values: M, F
friend
string
Whether the currently logged-in athlete follows this athlete. May take one of the following values: pending, accepted, blocked
follower
string
Whether this athlete follows the currently logged-in athlete. May take one of the following values: pending, accepted, blocked
premium
boolean
The athlete's premium status.
created_at
DateTime
The time at which the athlete was created.
updated_at
DateTime
The time at which the athlete was last updated.

SummaryClub

id
integer
The club's unique identifier.
resource_state
integer
Resource state
name
string
The club's name.
profile_medium
string
URL to a 60x60 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
May take one of the following values: cycling, running, triathlon, other
city
string
The club's city.
state
string
The club's state or geographical region.
country
string
The club's country.
private
boolean
Whether the club is private.
member_count
integer
The club's member count.
featured
boolean
Whether the club is featured or not.
verified
boolean
Whether the club is verified or not.
url
string
The club's vanity URL.

SummaryGear

id
string
The gear's unique identifier.
resource_state
integer
Resource state
primary
boolean
Whether this gear's is the owner's default one.
name
string
The gear's name.
distance
float
The distance logged with this gear.

SummarySegment

id
integer
The unique identifier of this segment
name
string
The name of this segment
activity_type
string
May take one of the following values: Ride, Run
distance
float
The segment's distance, in meters
average_grade
float
The segment's average grade, in percents
maximum_grade
float
The segments's maximum grade, in percents
elevation_high
float
The segments's highest elevation, in meters
elevation_low
float
The segments's lowest elevation, in meters
start_latlng
LatLng
An instance of LatLng.
end_latlng
LatLng
An instance of LatLng.
climb_category
integer
The category of the climb
city
string
The segments's city.
state
string
The segments's state or geographical region.
country
string
The segment's country.
private
boolean
Whether this segment is private.
athlete_pr_effort
SummarySegmentEffort
An instance of SummarySegmentEffort.

SummarySegmentEffort

id
long
The unique identifier of this effort
elapsed_time
integer
The effort's elapsed time
start_date
DateTime
The time at which the effort was started.
start_date_local
DateTime
The time at which the effort was started in the local timezone.
distance
float
The effort's distance in meters
is_kom
boolean
Whether this effort is the current best on the leaderboard

TimedZoneDistribution

A collection of #/TimedZoneRange objects. Stores the exclusive ranges representing zones and the time spent in each.

TimedZoneRange

A union type representing the time spent in a given zone.

min
integer
The minimum value in the range.
max
integer
The maximum value in the range.
time
integer
The number of seconds spent in this zone

UpdatableActivity

commute
boolean
Whether this activity is a commute
trainer
boolean
Whether this activity was recorded on a training machine
description
string
The description of the activity
name
string
The name of the activity
type
ActivityType
An instance of ActivityType.
private
boolean
Whether this activity is private

Upload

id
integer
The unique identifier of the upload
external_id
string
The external identifier of the upload
error
string
The error associated with this upload
status
string
The status of this upload
activity_id
integer
The identifier of the activity this upload resulted into

ZoneRange

min
integer
The minimum value in the range.
max
integer
The maximum value in the range.

ZoneRanges

A collection of ZoneRange objects.

Generated 2017-09-13T22:28:38.377Z