Running Races

A featured set of running races taking place across the world. Each race has an associated race page with course information, athlete goals, and results.

Detailed representation attributes

id:	integer
resource_state:	integer indicates level of detail. Possible values: 2 -> ‘summary’, 3 -> ‘detail’
name:	string
running_race_type	integer 0: road, 1: trail, 2: track, 3: xc
distance	float race distance in meters
start_date_local	time string local datetime for race start
city	string
state	string
country	string
route_ids	Array of integers can be used to retrieve route information
measurement_preference	string “meters” or “feet”
url	string canonical strava url i.e. www.strava.com/running-races/:url
website_url	string official website url i.e. “http://www.baa.org/races/boston-marathon”

Summary representation attributes

The summary representation of the activity object is the same as the detailed representation, except it does NOT include these attributes:

    route_ids
    website_url

Race Distances

Common race distances have fixed distance values. These include:

1 Mile: 1609.34
5K: 5000.0
10K: 10000.0
Half Marathon: 21097.0
Marathon: 42195.0
50K: 50000.0
100K: 100000.0

Other races have custom distances. For example, a 50 Mile will be 80467.0 calculated as 1609.34 meters/mile.

Example race

{
  "id": 491,
  "resource_state": 3,
  "name": "Boston Marathon",
  "running_race_type": 0,
  "status": 1,
  "distance": 42195.0,
  "start_date_local": "2016-04-18T10:00:00Z",
  "city": "Boston",
  "state": "MA",
  "country": "USA",
  "route_ids": [
    127433
  ],
  "measurement_preference": null,
  "url": "2016-boston-marathon",
  "website_url": "http://www.baa.org/races/boston-marathon"
}

List races

This request is used to retrieve a list of races occurring in a year, ordered by occurrence date from oldest to most recent.

Parameters

year:

integer optional
defaults to the current year

Returns a summary representation of races.

Definition

GET https://www.strava.com/api/v3/running_races/:year

Example request

$ curl -G https://www.strava.com/api/v3/running_races \
    -d year=2015 \
    -H "Authorization: Bearer AUTH_TOKEN"

Example response

[
  {
    "id": 164,
    "resource_state": 2,
    "name": "Walt Disney World Half Marathon",
    "running_race_type": 0,
    "status": 1,
    "distance": 21097.0,
    "start_date_local": "2015-01-10T05:30:00Z",
    "city": "Lake Buena Vista",
    "state": "FL",
    "country": "USA",
    "measurement_preference": null,
    "url": "2015-walt-disney-world-half-marathon"
  },
  {
    "id": 129,
    "resource_state": 2,
    "name": "Walt Disney World Marathon",
    "running_race_type": 0,
    "status": 1,
    "distance": 41295.0,
    "start_date_local": "2015-01-10T05:30:00Z",
    "city": "Lake Buena Vista",
    "state": "FL",
    "country": "USA",
    "measurement_preference": null,
    "url": "2015-walt-disney-world-marathon"
  }
]

Retrieve race details

This request is used to retrieve details about a running race.

Parameters

id:	integer required

Returns a detailed representation of the race.

Definition

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

Example request

$ curl -G https://www.strava.com/api/v3/running_races/491 \
    -H "Authorization: Bearer AUTH_TOKEN"