Model#

Athletes#

AthleteStats

Summary totals for rides, runs and swims, as shown in an athlete's public profile.

MetaAthlete

Represents an identifiable athlete with lazily loaded property to obtain this athlete's summary stats.

SummaryAthlete

The Summary Athlete object.

DetailedAthlete

Represents high level athlete information including their name, email, clubs they belong to, bikes, shoes, etc.

AthletePrEffort

An object that holds athlete PR effort attributes.

AthleteSegmentStats

A structure being returned for segment stats for current athlete.

Activities#

MetaActivity

Represents an identifiable activity with lazily loaded properties to collect this activity's comments, zones, kudos and photos.

SummaryActivity

The Activity object that contains high level summary activity for an activity.

DetailedActivity

Represents an activity (ride, run, etc.).

ClubActivity

Represents an activity returned from a club.

ActivityTotals

Contains a set of total values for an activity including elapsed time, moving time, distance and elevation gain.

Lap

An object that represents an Activity lap.

Split

A split -- may be metric or standard units (which has no bearing on the units used in this object, just the binning of values).

RelaxedActivityType

This object supports allowing an array of Literal values to be used for Activity Type.

RelaxedSportType

A class that extends the list of Literal values allowed for Sport Types that are defined in the generated strava_model module.

ActivityZone

Base class for activity zones.

TimedZoneDistribution

A single distribution bucket object, used for activity zones.

Activity Photos#

Note: the activity photo classes are defined differently in the Strava spec. This section will likely need to be updated. These endpoints are not well documented.

ActivityPhotoPrimary

Represents the primary photo for an activity.

ActivityPhoto

A full photo record attached to an activity.

Clubs#

MetaClub

Represents an identifiable club with lazily loaded properties to obtain this club's members and activities.

SummaryClub

Represents a single club with detailed information about the club including the club's location, activity types, etc.

DetailedClub

The detailed club object contains all of the club data available to the authenticated Athlete.

Routes and Segments#

LatLon

Stores lat / lon values or None.

SummarySegment

Contains summary information for a specific segment

Segment

Represents a single Strava segment.

SegmentExplorerResult

Represents a segment result from the segment explorer feature.

Map

Pass through object.

Route

Represents a spatial route created by an athlete.

Stream

Stream of readings from the activity, effort or segment.

Segment Efforts#

Split

A split -- may be metric or standard units (which has no bearing on the units used in this object, just the binning of values).

BaseEffort

Base class for a best effort or segment effort.

BestEffort

Class representing a best effort (e.g. best time for 5k).

SegmentEffort

Class representing a best effort on a particular segment.

SegmentEffortAchievement

An undocumented structure being returned for segment efforts.

SummarySegmentEffort

Returns summary information for a segment in an activity.

Webhook Subscriptions#

Subscription

Represents a Webhook Event Subscription.

SubscriptionCallback

Represents a Webhook Event Subscription Callback.

SubscriptionUpdate

Represents a Webhook Event Subscription Update.

Custom Types#

Distance([x])

A class for representing distances as quantities (using meter as unit, which is the implicit default of Strava).

Duration

A class that calculates the duration or time elapsed for an activity, activity segment, or activity lap.

Timezone

A class to represent and manipulate time zone information.

Velocity([x])

A class for representing velocities as quantities (using meters per second as unit, which is the implicit default of Strava). These quantities can then

Stravalib helpers#

BoundClientEntity

A class that bounds the Client object to the model.

naive_datetime(value)

Utility helper that parses a datetime value provided in JSON, string, int or other formats and returns a datetime.datetime object.

lazy_property(fn)

Should be used to decorate the functions that return a lazily loaded entity (collection), e.g., the members of a club.

check_valid_location(location)

Validate a list of location xy values.