Routes

Routes are manually-created paths made up of sections called legs. Currently it is only possible to create routes using the Routebuilder web interface.

Detailed representation attributes  

id: integer
resource_state: integer
indicates level of detail. Possible values: 1 -> ‘meta’, 2 -> ‘summary’, 3 -> ‘detail’
name: string
description string
athlete object
meta or summary
distance float
meters
elevation_gain float
meters
map object
maps summary
type string
1 for ride, 2 for run
sub_type string
1 for road (ride and run), 2 for mtb, 3 for cx, 4 for trail, 5 for mixed
private boolean
starred boolean
true if authenticated athlete has starred route
timestamp integer
DEPRECATED
created_at: time string
updated_at: time string
estimated_moving_time integer seconds
segments object
all segments that a route traverses or if segment_targets is enabled starred segments that start & stop on the route

Summary representation attributes  

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

    segments


Meta representation attributes  

id: integer
resource_state: integer
indicates level of detail. Possible values: 1 -> ‘meta’, 2 -> ‘summary’, 3 -> ‘detail’
name: string
map object
maps summary


Map summary attributes  

id: integer
summary_polyline: object
resource_state: integer
indicates level of detail. Possible values: 1 -> ‘meta’, 2 -> ‘summary’, 3 -> ‘detail’

Map summary attributes returned in route detailed representation only

polyline: object


Example route

{
  "athlete": {
    "id": 265720,
    "resource_state": 2
  },
  "description": "",
  "distance": 173625.6,
  "elevation_gain": 2964.6,
  "id": 1263727,
  "map": {
    "id": "r1263727",
    "summary_polyline": "qyrFxswgV|",
    "resource_state": 3
  },
  "name": "New Years Resolution - Santa Cruz Century Edition",
  "private": false,
  "resource_state": 3,
  "starred": false,
  "created_at": "2009-09-28T02:29:27Z",
  "updated_at": "2017-07-04T16:48:36Z",
  "type": 1,
  "segments": [
    {
      "id": 3799,
      "resource_state": 2,
      "name": "Highway 9 - HWY236 to Skyline"
    }
  ]
}

 

Retrieve a route

This request is used to retrieve details about a route. Private routes can only be accessed if owned by the authenticating user and the token has view_private permissions. For raw data associated with a route see route streams.

Parameters

route_id: integer required

Returns a detailed representation of the route.

Definition

GET https://www.strava.com/api/v3/routes/:route_id

Example request

$ curl -G https://www.strava.com/api/v3/routes/1263727 \
    -H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"

 

List routes

Returns a list of the routes created by the authenticated athlete using their athlete ID.

Private routes will only be included if the authenticating user is viewing their own routes and the token has view_private permissions. Pagination is supported.

Parameters

type: string optional
‘run’ or ‘ride’
after: unix timestamp optional
seconds since UNIX epoch, results will only include routes whose updated_at is after this value

Returns a list of an athlete’s routes in summary representation.

Definition

GET https://www.strava.com/api/v3/athletes/routes

Example request

$ curl -G https://www.strava.com/api/v3/athletes/265720/routes \
    -H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"

Example response

[
  {
    "athlete": {
      "id": 19,
      "resource_state": 2
    },
    "id": 743064,
    "resource_state": 2,
    "description": "",
    "distance": 17781.6,
    "elevation_gain": 207.8
  }
]