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"